Skip to content

Enable Multilingual Module

User role

Mukurtu manager

The Mukurtu Multilingual module enables the required Drupal multilingual modules (Configuration Translation /admin/config/regional/config-translation, Interface Translation /admin/config/regional/translate, and Content Translation/admin/config/regional/content-language), and configures recommended default settings for most multilingual work. If necessary, these settings can be modified after enabling the Mukurtu Multilingual module. Follow the instructions below to configure your site to display your site's elements and content in multiple languages.

Enable module

  1. From the Dashboard, navigate to the Multilingual section and select the Enable multilingual link.

    Screenshot of the dashboard featuring the multilingual section with enable multilingual highlighted.

  2. Select the "Enable multilingual" button to installs and configure Mukurtu Multilingual, Configuration Translation, Interface Translation, and Config Translation PO modules.

    Screenshot of the enable multilingual confirmation page with the enable multilingual button highlighted.

  3. You will receive a message asking you to confirm that you want to install all of the associated modules. Select "Continue".

    Screenshot of the message asking you to confirm whether you want to install all of the multilingual modules.

  4. You will receive a status message confirming that your modules have been installed and redirected to the Languages page. Follow the instructions below to add one or more languages to your site.

    Screenshot of the Languages page with the status message showing that multilingual is enabled.

Add Languages

You can add your language for translation on the redirected Languages page immediately after enabling your multilingual modules. If you choose not to add a language at that time, you can add languages later. From the Dashboard, navigate to the Multilingual section and select the Manage site languages link or go directly by going to /admin/config/regional/language.

Screenshot of the multilingual section of the dashboard with the manage site languages link highlighted.

Add a language

Adding a language allows users to use the site in that language, imports any Drupal translations, and allows for interface and content translation. It does not auto-translate a site's content or interface.

  1. Select the "Add language" button in the top right-hand corner of the Languages configuration page.

    Screenshot of the languages configuration page with the add language button highlighted

  2. Select a language from the dropdown menu. If your language is not listed in the dropdown menu, refer to the Add a custom language code section of this article for instructions on how to add your language.

    Screenshot of the Add language page with the dropdown menu set to French.

  3. Select the "Add language" button to add the selected language to your site.

  4. You will receive a confirmation message that your language has been added successfully.

    Screenshot of the status message confirming that a language has been added successfully.

Add a custom language

  1. If your language is not available, select the "Custom language" option to provide a language code and other details manually. For more information on translating site elements, refer to the Configuration Translation and User Interface Translation articles.

  2. Add your language code in the Language code field.

  3. Add the name of your language in the Language name field.
  4. Select a text direction for your language.
  5. Select the "Add custom language" button to import your language.

For more information on language tags and subtags, visit the IANA Language Tags Registry Primary Language Subtag article. For help configuring a custom language tag, please contact Mukurtu Support at support@mukurtu.org.

Screenshot of the Add language page with the dropdown menu set to Custom language...and the fields available, filled in and highlighted, as well as the text direction and Add language button.