Joomla Multilingual SEO: How to Set Up Hreflang & Language Associations (2026 Guide)

What you'll need	Details
Joomla version	5.4.x or 6.x (Joomla 4 reached end of life on Oct 14, 2025 — upgrade first if you're still on it)
Access level	Super User / Administrator
Language packs	Installed via Install Languages screen for each target language
SEF URLs	Enabled in Global Configuration → SEO
Content	Human-translated copy for each language (machine translation only is not recommended for SEO)

This guide covers Joomla's native multilingual system — the same feature set used for the language associations, hreflang tags, and menu structure described below. No third-party translation extension is required for the core setup; optional paid extensions are covered near the end for teams that want managed translation workflows.

🖼️ [ẢNH CẦN CHỤP — HERO] Overview screenshot of a Joomla site's frontend with a visible language switcher module (flags or language names) in the header or sidebar, showing two live language versions side by side or in two browser tabs.

Step 1: Install and Publish Your Content Languages

Go to Extensions → Languages → Install Languages and download the language pack for each language you plan to support. Installing a language pack translates Joomla's admin interface and front-end system strings — it does not translate your articles. After installing, go to Extensions → Languages → Content Languages and create a Content Language entry for each language, then set its status to Published. Each Content Language needs its own language tag (e.g. en-GB, fr-FR) — this tag is what Joomla later uses to generate the correct hreflang value.

🖼️ [ẢNH CẦN CHỤP — BƯỚC 1] Joomla admin, Extensions → Languages → Content Languages list, showing at least two languages with the Published (green check) status column visible.

Step 2: Enable the Language Filter and Language Code Plugins

Go to Extensions → Plugins and search for "language." Enable System - Language Filter and System - Language Code. Open the Language Filter plugin's settings and set Item Associations to Yes — this single setting is what unlocks the Associations tab on articles, categories, and menu items in the next step, and it's also required for Joomla to output hreflang alternates automatically.

🖼️ [ẢNH CẦN CHỤP — BƯỚC 2] Language Filter plugin edit screen with the "Item Associations" field visibly set to Yes — crop or circle this field in red.

Step 3: Create a Separate Menu for Each Language

Go to Menus → Manage → Add New Menu and create one menu per language (for example, "Main Menu EN" and "Main Menu FR"). Add menu items to each menu as you normally would, then open each menu item and assign it to its corresponding language in the Basic Options — items assigned to "All" languages will show up regardless of which language the visitor is viewing, which breaks the language-switching logic. For each language menu, set one item as the default (star icon) so it loads as that language's homepage.

🖼️ [ẢNH CẦN CHỤP — BƯỚC 3] Menu Manager list showing two separate menus (e.g. "Main Menu EN" and "Main Menu FR") with their assigned language visible in the list.

Step 4: Link Translations Through Associations

Open an article, category, or menu item and go to its Associations tab (only visible after Step 2). Click into the field for the target language and either search for an existing translated item or click Create to generate a linked draft, then write or paste the translated title and body. Repeat for every content type you want to appear in multiple languages: articles, categories, and menu items each have their own Associations tab and need to be linked separately — associating an article does not automatically associate its category.

🖼️ [ẢNH CẦN CHỤP — BƯỚC 4] Article edit screen, Associations tab open, showing the dropdown/search field for linking to the translated version of the article in a second language.

Step 5: Fix the Site Domain Field So hreflang and Canonical Both Work

Go to Extensions → Plugins → System - SEF and check the Site Domain field. This is the step most multilingual Joomla sites get wrong: if Site Domain is left empty, Joomla still outputs the hreflang alternate tags, but it silently drops the canonical URL tag from the page head. Enter your full domain (including https://) here, then confirm "Add alternate meta tags" is enabled in the Language Filter plugin from Step 2. View your page source afterward and confirm you see one tag per language, one hreflang="x-default" tag pointing to your default language version, and a separate tag.

📊 [ẢNH CẦN CHỤP — BƯỚC 5] Browser "View Page Source" screenshot with the hreflang link tags and the canonical link tag both visible in the , ideally with the tags highlighted or boxed.

Step 6: Add a Language Switcher Module

Go to Content → Site Modules → New → Language Switcher, assign it to a visible position (such as a header or sidebar position in your template), and set it to display on all pages. Publish it, then visit the front end and confirm all published languages appear and switching between them lands the visitor on the correct translated URL for the same piece of content — not on the homepage of the other language.

📱 [ẢNH CẦN CHỤP — BƯỚC 6] Front-end screenshot of the published Language Switcher module in its final position on the live site, both desktop and mobile view if space allows.

Step 7: Translate Meta Titles, Descriptions, and URL Aliases

For each translated article, open the Publishing tab and write a unique Meta Description in that language — do not leave it copied from the source language. Also edit the URL alias field so the slug itself is localized (for example /en/pricing and /fr/tarifs rather than /fr/pricing). Localized slugs are one of the more overlooked ranking signals for international SEO, since they give both users and AI crawlers an extra language cue directly in the URL.

Step 8: Submit Language-Specific Sitemaps in Search Console

If your sitemap extension generates one combined XML sitemap, check whether it annotates each URL with hreflang alternates inside the sitemap itself; if not, generate and submit a separate sitemap per language in Google Search Console under each language's dedicated property or directory. This gives Google a second, redundant path to discover your language associations even if a crawl ever misses the in-page hreflang tags.

Common Mistakes to Avoid

• Leaving Site Domain empty in the SEF plugin. As shown in Step 5, this silently removes the canonical tag while hreflang tags still appear — a known behavior reported on Joomla's public issue tracker for Joomla 5.2.0 and later.
• Forgetting to set Item Associations to Yes. Without it, there's no way to link translations, and Joomla can't build hreflang relationships between language versions.
• Assigning menu items to "All" languages. This breaks the language-filtering logic that the switcher and hreflang tags rely on.
• Relying only on machine translation. Untranslated or poorly translated meta descriptions and body copy hurt both user trust and how confidently an AI answer engine can cite the page.
• Associating articles but not their categories or menu items. Each content type needs its own Associations link — partial associations produce inconsistent hreflang output across a site.
• Using the same URL alias across languages. Non-localized slugs (e.g. /fr/pricing) waste a low-effort, high-value localization signal.

Optional: Premium Multilingual Extensions Worth Knowing

Joomla's native system above is enough for most sites. Two extensions are commonly used when a team wants a faster or more automated translation workflow:

GTranslate's paid tier adds neural machine translation, editable translations, SEF URLs per language, and automatic hreflang/canonical tag generation on top of its free browser-widget mode, which does not include SEO-indexable translated pages.

Falang works alongside Joomla's built-in multilingual system rather than replacing it, and shows translation status directly inside the article, menu, and module managers. Its free version has a backlink requirement removed only in the paid Basic/Standard/Pro tiers; the Pro tier additionally allows use across multiple sites. Current Falang releases support Joomla 5 and 6.

❓ Frequently Asked Questions

Does Joomla add hreflang tags automatically?

Yes, once you set Item Associations to Yes in the Language Filter plugin and link your translated content through the Associations tabs. Joomla then outputs one hreflang alternate tag per linked language plus an x-default tag, without any extra extension.

Do I need a paid extension for multilingual SEO on Joomla?

No. Joomla's built-in Content Languages, Language Filter plugin, and Associations system cover hreflang, language-specific URLs, and translated menus natively. Extensions like GTranslate or Falang are optional conveniences, not requirements.

Subdirectories or subdomains — which URL structure is better for multilingual SEO?

Joomla's native multilingual system is built around subdirectory-style URLs (e.g. /fr/), which is also the structure most Joomla tutorials and documentation assume. Subdomains or separate ccTLDs are possible but require more manual server and DNS configuration outside Joomla itself.

Does each language need its own XML sitemap?

It's not strictly required if your sitemap extension annotates hreflang alternates inside a single combined sitemap, but submitting a separate sitemap per language in Google Search Console gives search engines an extra, more reliable path to discover your language associations.

Why does my canonical tag disappear even though hreflang tags show up correctly?

This happens when the Site Domain field in the System - SEF plugin is left blank. Joomla still generates hreflang alternates in that case, but drops the canonical tag — fill in your full domain, including https://, to fix it.

Which Joomla version should I use for a new multilingual site in 2026?

Use Joomla 6.x or 5.4.x — both are currently supported. Joomla 4 reached end of life on October 14, 2025 and no longer receives security updates, so avoid building new multilingual sites on it.