Skip to content

Joomla can run a site in several languages with no extra extension. These steps work in Joomla 5 and Joomla 6.

Step 1: Install the languages

Go to System, then Languages in the Install panel, and install each language you need. This translates Joomla's own text, such as buttons and form labels.

Step 2: Set up content languages

Go to System, then Content Languages in the Manage panel. Check there's a published entry for each language, with a short URL code, such as en or fr.

Step 3: Turn on the Language Filter plugin

Go to System, then Plugins, and enable System - Language Filter. This adds the language code to your URLs and lets Joomla choose which content to show. Only enable it after Step 2.

Step 4: Give each language a home page

Each language needs a home menu item of its own, set to that language. Create a menu for each language, add its pages, and make one item the Home for that language.

Step 5: Add a Language Switcher

At Content, then Site Modules, add a Language Switcher module and put it somewhere easy to find, such as the header.

Step 6: Translate and link your content

Make a copy of each article in the other language, and set its Language field. To link the versions of a page, use the Associations tab on the article, or the Multilingual Associations screen. Then the switcher takes visitors to the same page in the other language, and search engines see the link too. Do the same for categories, menus and modules. A module set to one language appears only on that language's pages.

What about automatic translation?

Joomla doesn't translate your content for you. Extensions in the Joomla Extensions Directory can do this. Have a person check anything that matters, such as prices, terms and checkout pages.

Check your template

Text in your template settings, such as a slogan, doesn't change with the language. If you need that, use a separate template style for each language, assigned to its menu items. Check long words on buttons and menus too, because translations often run longer than English. Shop sites also need their VirtueMart product text translated, which is a separate job. Browse our templates and try the demos.