If your project plans to enroll participants whose primary language is not English, you can configure your project’s content (including names & descriptions, surveys, and notifications) to display in additional languages.
The MyDataHelps app (names, descriptions, and surveys) will utilize the primary language setting of the device. The Preferred Language demographic field determines which language is used when sending notifications.
Supported Languages
MyDataHelps supports the following languages:
- Dutch (nl)
- English (en)
- French (fr)
- German (de)
- Italian (it)
- Polish (pl)
- Portuguese — Brazil (pt)
- Portuguese — Portugal (pt-pt)
- Spanish (es)
If you need to configure your project for a different language, please contact us.
Adding Additional Languages
To configure your project for additional languages, you will need to update the following:
- Workspace Settings (Display Name & Display Description)
- Project Settings (Display Name, Display Description, & Learn More Title)
- App Layout (Tab Title)
- Survey Content
- Notification Content
Workspace Settings
The Organization Display Name and Description can be updated by clicking the “Default” drop down to the right of the text field within the Workspace Settings. Once you’ve added the translated display name, click “Save Settings” at the bottom of the page.
Project Settings
Next, you should update the project’s Display Name, Display Description, Learn More Title (if applicable), Supported Languages, and Default Language. These settings can be located in the About Settings tab within your project. Once updated, make sure to click Save Project Settings at the bottom of the page.
App Designer
If your project utilizes the participant-facing MyDataHelps app, start by adding the translated Title of each tab within the app by going to App Designer, clicking on the tab to edit, then updating the Title field. From there, click Save and Customize to add translations to the view.
Within the view, update the language of the view in the upper right corner, and then add translations for any of the participant-facing text in that view. Once done, click Save & Exit in the bottom right corner.
The names of custom fields and logic used for piping should not be translated within the view editor.
Survey Content
The translated Survey Name and Survey Description can be updated within the survey’s Settings tab.
The contents of the survey can be updated by switching Languages on the left hand side of the Survey Editor, then editing the content.
For more information, see Creating Multilingual Surveys.
Notification Content
To update notification content, open an existing notification, switch the Language at the top of the Edit Notification window, update the text fields, then click Save in the bottom right corner.
For more information, see Creating Multilingual Notifications.
Collecting the Participant's Preferred Language
The Preferred Language demographic field determines what language is used when sending notifications. If the Preferred Language field is left blank, notifications will be sent in the default language, English. If this field is not left blank, it must be one your project's supported languages.
For example, if you will be using a survey question to populate Preferred Language and your study was configured for three languages, you would create a survey step with the following settings.
When populating the Preferred Language, the answer choice values must correspond to the language values listed in parentheses in the Supported Languages section.
See Populating Participant Fields for more information on how to populate this demographic field.
Testing Additional Languages
Once you’ve updated and saved all of the configurable settings mentioned above, you should enroll a test participant in your project and verify that all of the translations appear as expected.
The MyDataHelps app will utilize the primary language setting of the device, while the notifications (email, push, SMS) will respect the Preferred Language demographic field value for the participant.
To begin testing, update the language used by the app in one of three ways:
- Change the primary language in the device’s settings (all platforms).
- Update the preferred language within the MyDataHelps app’s settings (mobile app only).
- Toggle between English and Spanish in the upper right corner of the screen by clicking the language button (web only).
From there, navigate to the MyDataHelps app on your device and confirm the workspace, project, and tab settings have been translated.
Next, deliver a survey to the test participant and confirm that you see the translated version.
The translated survey version(s) must be published to the Dry Run project before testing as a participant.
If you've added translations for coordinator surveys, those can either be tested by using the "Try It Out" button within the survey editor or you can update the browser language settings to display in the language you wish to test. Once the browser language has been updated, navigate to your test participant in MDHD and launch the coordinator survey to test the translations.
Finally, update the participant’s preferred language:
- Click on the participant from the Participants tab.
- Navigate to the Participant Info tab.
- Update the Preferred Language.
- Click Save in the bottom right corner.
If your project uses a survey to update the participant's preferred language setting, you should test that as well.
Once the preferred language has been updated, send the participant a notification and confirm that they receive the translated version.