Language Translations

If you’d like to translate your Moodle site from English to another language, follow the steps below to install and configure language settings.


🌐 Step 1: Install a New Language Pack

  1. Navigate to:
    Site administration > Language > Language packs
  2. From the list of available languages, select the one you wish to install and click Install selected language pack.

🛠️ Step 2: Configure Language Settings

Go to:
Site administration > Language > Language settings

Here, you can configure:

  • Default language: Set the default language for all new users.
  • Force language: Prevent users from changing the language by enforcing the site default.
  • Language autodetect: Disable this if you want to ignore the browser language and apply the site’s default language.

💡 Changing the default language will only apply to new users. Existing users will retain their previously selected language unless manually changed.


📌 Note on Language Priority

Moodle follows a priority order when deciding which language to display:

  1. User profile setting
  2. Course setting
  3. Site default

For a visual representation, refer to the Moodle documentation:
🔗 Language selection priority


⚙️ Enable Localized Error Messages

To localize error messages (such as database connection errors), add this line to your config.php file:

$CFG->lang = 'yourlangcode';

Replace 'yourlangcode' with the code of the language you installed (e.g., 'fr' for French).


🧭 Display or Hide the Language Menu

You can control whether the language switcher menu is shown:

  • Go to:
    Site administration > Language > Language settings
  • Enable or disable the Display language menu option.

🧩 Note: The appearance and location of the language menu may vary based on your theme. For example, in the Boost theme, it appears in the top bar on the left, near the custom menu items.


📝 Translating Site Content

Once the site language is switched, you can start translating all visible content—such as course pages, blocks, and custom text—by editing them manually in the selected language.