Localization in Ethica can be divided into two general categories: localization of the app interface and localization of the study content. Each of these is explained below.
The Ethica mobile app for Android, iOS, and web is currently available in the following 10 languages:
If you are interested in helping us translate Ethica into your local language, we would love to hear from you.
The Ethica app for Android and iOS sets the language of the user interface to be the same as the system language. Every time the user opens the Ethica app, the app will check the current system language, and sets the app language accordingly. If Ethica is not available in the system language, it switches to English by default.
Participants can also choose the language of Ethica by opening the Ethica app,
going to the
Settings → Languages, and then choose their desired language.
This will override the language of their phone, and instructs Ethica to always
appear in the language they chose, regardless of the language of their phone:
Ethica supports creating studies where the content, for example, the informed consent, survey questions, or notifications, are translated and available in multiple languages. This way every participant interacts with the study using the language they have chosen.
By default, Ethica assumes your study is only available in one language. We refer to this as the Base Language. It can be any language. For example, if your participants are predominantly familiar with Dutch, you can consider Base Language to be Dutch. Note that you do not have to set Base Language to anything. Base Language just refers to the language of the content you enter in your study when no language is chosen.
Now you may choose to have your study only in one language, for example, Dutch. In this case, all you need to do is to enter all fields of study in Dutch. This way participants will also see the study in Dutch. In this case, we say the Base Language for your study is Dutch.
If you choose to add other languages to your study, you can do so via the Researcher Dashboard. In there, select your study and navigate to the Basics page. At the bottom of the page, you will find the Localization table.
As you have not added any localization, you will notice the table is empty.
+ Add to add a new language. Ethica supports study content
localization for the same 10 languages mentioned
above. So in the dialog that opens for adding a
new language, you can pick any of the above languages. Pressing
Add will add
the language to your study's localization table.
For example, in the above scenario, you may decide to add English translation
for your study as well, for those participants who cannot understand Dutch. In
this case, you can add
English to your study localization. Here we say your
study has two languages: the Base Language which is Dutch, and the English
If your study contains at least one localization, such as above that we added English to our Localization list, the Researcher Dashboard shows a Language Selector option next to all text and in some cases image fields across the entire study, as shown below:
Sometimes you might find the Language Selector at the top of a dialog or a section beside the title. In these cases, all available fields in that dialog or section are considered to be translatable, and you can provide translations for all of them by just changing the localization in that selector, as shown below:
In this case, when you are adding content to a given field, by default the content is considered for the Base language. You can open the Language Selector next to the field and choose one of the localizations, and then enter/select the translation of that content in the new language.
Note that the Base Language can be any language, not necessarily one of the languages listed here. You also can do the localization in any language. So in theory you can add the content of the Base Language in a language like Dutch, and add the same Dutch translation as well. While this is possible, it does not make sense semantically, and will have no impact on how Ethica shows the localized content.
If your study is available in multiple languages, Ethica chooses the right language before showing every content, for example before showing the app homepage or a given survey or a notification. Detecting the language happens based on the following algorithm:
- Ethica checks if the participant has chosen a language in the app's Settings. If yes, Ethica uses that as the participant's preferred language.
- If no, Ethica checks if the participant's phone has been set to a specific language. If yes, Ethica uses that as the participant's preferred language.
- If no custom language is chosen from steps 1 and 2, Ethica sets the participant's language to Base.
- For showing every content, Ethica checks if the content is provided by the researcher in the participant's preferred language.
- If the content is available in the participant's preferred language, that content is shown.
- If the content is not available in the participant's preferred language, the Base version of the content is loaded and shown.
Note that you must always provide the Base version of each content. So Ethica always can fall back to displaying the Base content.
To remove a given localization from your study, open the Researcher Dashboard,
select your study, and navigate to the Basics page. In the Localization
table, select the languages you want to remove, and press
Remove. You'll be
prompted with a confirmation dialog. If you confirm, the selected localizations
and all translated content related to them will be removed.
Note that this action cannot be reverted. If you have entered a substantial amount of localized content, removing the localization will delete all those and will be irrevokable.