This document provides a step-by-step guide to understanding the language support available in OpenClinica. It will explain how you can implement this model in your own study.

There are three types of text within OpenClinica that you may want translated:

  • System-Defined Text
    • Text that is not study-specific, such as the menus (Tasks, Share, Settings, etc.) and other standard system-generated text.
    • Translated text is provided by OpenClinica.
    • Current Supported Languages: English (en), German (de), Canadian French (fr-ca), & Spanish (es).
      • Please reach out to Customer Support or your Customer Success Manager if you’d like more languages added
  • Form-Specific Text
    • Text that is specific to the form definition, such as item labels, constraint messages, etc.
    • Translated text is provided by end users in the form template when they configure the study in Study Designer.
    • Note: Forms can be defined to use languages not yet supported by the OpenClinica system. In this case, the form interface (for example, button text and error messaging) will not match the language of user-defined form questions.
  • Study-Specific Text
    • Text that is study-specific, but not defined with the form definition, such as Study Name, Event Names, Form Names, Calendaring Notification Messages.
    • Translation capability is coming in a future release.

OpenClinica studies are configured to use only English (en) by default. You can change your study to use any available system languages by contacting Customer Support or your Customer Success Manager.

  • User/participant Language Determination:
    • When a user accesses Study Runner or a participant accesses the Participant Dashboard:
      • If their current browser language is a study-supported language, then the UI will be localized to that language.
      • If their current browser language is not a study-supported language, then the UI will be localized to the default study language.
    • When a system notification is sent to a Study Runner user:
      • If the user has not accessed the system yet, the notification will be sent in the default study language.
      • If the user has accessed the system already, the language determined by their access (see above) will be used for system notifications.
    • When a system notification is sent to a participant:
      • If the participant has not accessed the Participant Dashboard yet, the notification will be sent in the language selected by the user who initiated the most recent invitation to the participant.
      • If the participant has accessed the Participant Dashboard already, the language determined by their access (see above) will be used for system notifications.
    • When a Study Runner user or participant opens a form, it will be opened to the same language being used by Study Runner/Participant Dashboard (see above) if the form is configured to support that language. If the form is not configured to support that language, it will open in one of the other form languages.

The below table describes what Internationalization capabilities OpenClinica has for each component of the OpenClinica system.

OpenClinica FeatureLocalization Supported?Translation Done by User or OpenClinica?How is it Enabled?
Login PageYesOpenClinicaIf the studies are configured to support languages other than English, the login page will be available in all languages supported by OpenClinica.
OpenClinica Study Runner System TextYesOpenClinicaReach out to Customer Support or your Customer Success Manager to enable supported languages for the study.
System NotificationsYesOpenClinicaReach out to Customer Support or your Customer Success Manager to enable supported languages for the study.
Study Runner – FormsYesUserInclude translations in the form template as described in the Languages and Translations section of Using the Form Template.
Participant – DashboardYesOpenClinicaReach out to Customer Support or your Customer Success Manager to enable supported languages for the study.
Participant – FormsYesUserInclude translations in the form template as described in the Languages and Translations section of Using the Form Template.
InsightYesOpenClinica (Metabase vendor)Follow steps detailed in Configuring Metabase Languages and Localization.
Study Specific TextNo (planned for future)
Calendaring – NotificationsNo (planned for future)
Study Build System (Study Designer, Study Manager)No