Page Comparison

View the ‘How to use Multi-Language Management’ video within REDCap by navigating the MLM page found under ‘applications’ on the left hand project menu

1. Create project per normal process (define forms, create fields, events, etc.)

2. Click on MLM in Left Navigation panel under ‘applications’

3. Click ‘Add new language’

   

4. In the ‘Language ID’ box, add your desired Language ID

   1. It is recommended to use the ISO code, such as 'en' or 'en-US' for English, or 'es' for Spanish. Use only letters and hyphen. View list of ISO 639-1 language codes within the application as needed

   2. Enter your language ‘display’ name

   3. Click ‘Import from file or system’

      

5. CRITICAL STEP!

   1. The default selections are NOT used as a best practice

      1. De-select to include the ‘translations of user interface items’

      2. Select import ‘from available system languages’

      3. Select your language from the drop down menu

         • If you do not see the desired language listed after clicking the dropdown arrow, create a REDCap support ticket indicating what language you wish to utilize

      4. Click ‘import’

         

6. Your page should now look similar to the below where English is the first language listed and is identified as the defaultlanguage

   1. The vertical yellow line on the left indicates current changes are not yet saved. Click Save changes

   2. Save changes frequently and often to avoid re-work!

      Image RemovedImage Added

7. Select the participant's preferred language field

   Image RemovedImage Added

   1. If you don’t yet have a preferred language field save you changes thus far and go create you field following the below guidance:

      1. ensure the choices are labelled as the language code and not a numerical value:

         • example)

           

8. Activate your language(s)

   1. Under the "Active Column" click the radio button to activate each language.

   2. Only click the RTL radio button if the  language should be read right to left (like Arabic)

      

9. Enable items & translate using the Forms/Surveys tab

   

   1. Here you will toggle on which instruments will be used as ‘data entry’ and / or ‘survey’

      1. Select your first language and enabled accordingly

      2. Select you 2nd language and enable accordingly

         • Remember, you have to select the language at the top of this page that you wish to enable/translate

           Image RemovedImage Added

         • Remember to SAVE CHANGES frequently!

      3. Once data entry/surveys have been enabled, it’s time to translate!

   2. To begin translating items, select the desired language widget

   3. Select ‘translate’ under the fields column

      1. Image Modified

         Translate each field on the screen

         • You can use the Rich text editor to enhance your text (e.g. bold, italicize, center text)

           

      2. After you translate the field, a green icon indicates it is done.

      3. If the field is not to be translated (eg you wish some fields to remain in the default language, click the box next to the field variable name

         Image RemovedImage Added

      4. Translate any/all desired survey settings

      5. Click through tabs to translate each of the topic areas (e.g. Forms/surveys, Alerts, etc.)

      6. If your projects utilizes ASI’s (automated Survey Invites) you must select each ASI’s Language source. Best practice is to select the ‘language preference field’ for the best results!

         

      7. Save Changes!

10. NOTE: When translating Alerts, ensure you set language source for each alert.

    1. This drives the language for the alert.

       1. As a best practice, the participants language preference field should be used.

    Image RemovedImage Added

11. Save changes and review your MLM setup for accuracy

    1. Shortcut to save is by using your keyboard buttons (Control + S)

12. Test your project configuration in development mode for accuracy and adjust as needed