Setup a Multilingual Site/Installing New Language
From Joomla! Documentation
How to setup a Multilingual Joomla! Site
Articles in this Series
Joomla! allows you to create easily a multilingual website, without having to install any third party extension. In this tutorial, you’ll find a complete walkthrough of the steps involved in creating a multilingual Joomla! site.
Step 1 - Installing a new language
Option 1: Setup a Multilingual site on an existing site
- 1 Step 1 - Installing a new language
- 2 Option 1: Setup a Multilingual site on an existing site
- 3 Option 2: Setup a multilingual site during a new installation
In this tutorial, the default language of the site is English. For users speaking another language, there should be a language switch available giving them access to the same content but in a different language. Here, we’ll use French as the second site language - but that’s just for demonstration purposes. You can follow along with the steps below using any language you need.
Although creating a multilingual website isn’t complicated, it involves following a number of essential steps. Therefore, we’ll start with a fresh install of Joomla! 3.x, without sample data. This way, we can keep things simple and get a good idea of the full process. After you’ve mastered the basic principles, it’s easier to apply them to an existing site that already contains content in one language.
Checking which languages are currently available
After installing Joomla, one language is available. You can check this by navigating to Extensions → Language(s). In this example, the currently installed language is British English (en-GB).
In the side menu, Installed - Site indicates the language Joomla! uses in the frontend (texts such as Read more, Articles and Category). By clicking on Installed - Administrator you can see what language is installed for the backend.
Adding a new language
First, let’s add the language files for the language we want to use as the second language on our site. This involves two steps:
- installing the French language package
- telling Joomla! we want to use it as a content language.
Installing a new language package
Let's install the French language package.
- Go to Extensions → Language(s)
- Click the button at the top left Install Language.
A list of available translations is displayed. You can easily find the desired language by using the Search function. In this field, enter French.
Check the box on the left side of French language and click the top left button Install. Then, a message is displayed: Installation of The French(FR) was successful. Mission accomplished! In the Languages screen (accessed through Extensions → Language(s)), you can now see that French (fr-FR) language is now available.
Option 2: Setup a multilingual site during a new installation
Before you complete your installation by deleting the Installation Folder, click on → Extra steps: Install languages package.
This will continue the installation of Joomla! by taking you to a new installation page. A list of language packs is now displayed.
Check the language or language packs you wish to install, in our case the French package. Remember the following:
- Language packs included in custom distributions will not be listed at this stage as they are already installed.
- A version of the packs proposed will match the Joomla! Major version (3.0.x, 3.1.x, etc.). The minor version of the pack may not correspond.
- Unmatched language packs in the above example may have untranslated strings.
- The unmatched language packs will be offered as an update when the packs are updated by the registered Translation teams. The available update will be shown in the Control panel as well as in Extensions Manager → Update. This behavior is similar to Extensions Manager → Install Languages.
- Click Next and a progress bar will be displayed while the language pack/packs are downloaded.
Choose Default Language
When the download is complete you can choose the default language for the Site and the Administrator interface.
- Make your choices for default languages and activate the multilingual features of Joomla.
- Click Yes next to Activate the multilingual feature
- Two additional choice will appear.
- Install localised content, yes or no. This will automatically create one content category for each language installed and one featured article with dummy content for each content category installed.
- Enable the language code plugin, yes or no. If enabled, the plugin will add the ability to change the language code in the generated HTML document to improve SEO.
- Two additional choice will appear.
When you completed all the choices of language installation, click Next to proceed.
You will now be presented with a very similar Congratulations! Joomla! is now installed. screen. The difference will be a notation of the default Administrator and Site language settings. Now you can click on the button Remove installation folder.