Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

WPML Language Switcher Not Working: Causes and How to Fix It

WPML Language Switcher Not Working: Causes and How to Fix It

Short answer

The WPML language switcher usually stops working because it was never enabled for a visible location, the translated menu is missing or unassigned, pages have no translations, or a cache or CSS hides it. Check WPML switcher settings first, then menus, translations and caching.

Key takeaways

  • Each WPML switcher type must be enabled under WPML > Languages.
  • Translated menus must exist and sit in the same theme location.
  • Builder and block theme headers need the WPML widget or block.
  • Pages with no translation hide the language or link to the home page.
  • Clear plugin, host and CDN caches after any switcher change.

Why is the WPML language switcher not working?

The WPML switcher usually fails because it was never enabled for a visible location, the menu is not set up for each language, translations are missing, or a cache or custom CSS hides it.

WPML gives you several switcher types: a menu switcher, a widget switcher, a footer switcher, a switcher above or below posts, and custom switchers you place with a block, shortcode or PHP. None of them appear until you turn them on in WPML settings.

Most not working reports fall into one of these groups:

  • The switcher does not show at all
  • It shows in the default language but disappears on translated pages
  • Clicking a language goes to the home page instead of the translated page
  • Some languages are missing from the list
  • Flags or names look broken, or the dropdown will not open
  • The language changes once, then flips back

Work through the sections in order. Each one rules out a common cause before you move to the next.

Is the switcher turned on in WPML settings?

Open WPML > Languages and scroll to the language switcher sections, because each switcher type must be added there before it shows anywhere on your site.

On the Languages screen you will find separate areas for menu switchers, widget switchers, the footer switcher and links above or below posts. Each one has its own Add or Enable control and its own options for flags, native names and display names.

Check these points:

  1. Click the button to add a menu language switcher and pick the menu it should attach to
  2. Choose the position, such as first or last item in the menu
  3. Pick what each item shows: flag, native name, name in the current language, or a mix
  4. Save, then reload the front end in a private window

If you only enabled the footer switcher, but your theme hides the footer area WPML uses, you will see nothing. Try the menu option instead to confirm WPML itself is fine.

The WPML documentation on language switcher options shows every switcher type and setting in one place.

Is your menu translated for every language?

WPML attaches a menu switcher to one menu, so it disappears on translated pages if that menu has no translation or the translated menu is not assigned to the same theme location.

This is the most common reason the switcher shows in English but not in French or German. WPML treats each language version of a menu as a separate menu.

Fix it like this:

  1. Go to WPML > WP Menus Sync and sync your menus
  2. Open Appearance > Menus and switch the admin language bar to each language
  3. Check that each translated menu exists and is assigned to the same theme location
  4. Re-open WPML > Languages and confirm the switcher is still attached to the main menu

If you use a block theme, menus live in the Navigation block instead of Appearance > Menus. In that case, add the language switcher block inside the header template part and check it in each language.

For a full walkthrough of menu translation, see our guide on how to use the WPML plugin in WordPress.

Does your theme or page builder support the switcher location?

Some themes and builders draw their own header, so a menu switcher attached to a classic menu location never reaches the page, and you need the builder's widget or a block instead.

Page builders such as Elementor, Divi and Beaver Builder often build headers from their own templates. If the header uses a builder menu widget, it may not output WPML's extra menu items in the way you expect.

Use the right method for your setup:

Site setupBest switcher method
Classic theme with menusWPML menu switcher
Block themeWPML language switcher block in the header template part
Elementor headerWPML language switcher widget inside Elementor
Sidebar or footer widgetsWPML widget switcher
Custom theme codewpml_add_language_selector action or the shortcode

For Elementor sites, the compatibility layer must be active, which depends on WPML String Translation and the right add-ons. Our WPML with Elementor guide covers the setup.

If the widget is missing or throws errors, read WPML Elementor not working for the common causes.

For developers, WPML provides a hook and a shortcode for custom switchers. Check the current names in the WPML custom switcher documentation before you add code, since a typo fails silently.

Do your pages have translations?

WPML only links to a language when the current page has a published translation, so on untranslated pages the switcher either hides that language or sends visitors to the home page.

In the language switcher options, WPML lets you choose what happens when a translation is missing. You can skip that language, or link to the home page of that language. Both look like broken behavior to a visitor who expects the same page in another language.

Check the page you are testing:

  • Open the page in the editor and look at the Language box
  • Each language should show a pencil icon, meaning a translation exists
  • A plus icon means there is no translation yet
  • A translation that is still in progress or in draft will not appear on the front end

If translations exist but are not showing, the problem is usually in the translation workflow, not the switcher. Our guide to WPML translation not working covers stuck jobs and missing translations.

Is a cache serving the wrong language?

A page cache or CDN can save one language version and serve it to everyone, so the switcher looks dead or the language flips back after one click.

This happens most often when the cache key does not include the language. WPML supports three URL formats: languages in directories, languages in subdomains or separate domains, and a language parameter in the query string. Directory and domain formats give each language its own URL, which caches cleanly.

Work through this list:

  1. Check WPML > Languages > Language URL format and prefer directories or domains
  2. Clear your caching plugin cache
  3. Purge any host cache from your hosting panel
  4. Purge your CDN, such as Cloudflare
  5. Test again in a private window

WPML also keeps its own cached data. If switcher changes do not stick after you save, follow our steps on how to clear the WPML cache.

Browser language redirection can add confusion. If redirect visitors based on browser language is on, a visitor may land on one language no matter what they clicked before. Turn it off while you test.

Is CSS or JavaScript hiding the switcher?

The switcher may be on the page but hidden by theme CSS, a missing WPML stylesheet, or a JavaScript error that stops the dropdown from opening.

Right-click where the switcher should be and choose Inspect. If you can find an element with a class that starts with wpml-ls, the switcher is being printed. The problem is styling, not WPML logic.

Common styling causes:

  • Theme CSS sets the menu item to display none on mobile or desktop
  • An optimization plugin removed or deferred the WPML stylesheet
  • A remove unused CSS feature stripped the switcher styles
  • The dropdown relies on JavaScript that a minify or delay setting broke

Open the browser console and look for red errors. The Chrome DevTools console guide explains how to read them. If errors point to a minified file, exclude WPML assets from minification or delay settings in your performance plugin.

WPML also has a setting to add your own CSS for the switcher and an option to stop loading its default CSS. If someone ticked the option to not load the CSS, the dropdown may render as a plain list or stay hidden.

Could a plugin or theme conflict be the cause?

Yes, conflicts are common, so test with a default theme and only WPML plugins active to see whether the switcher returns.

Do this on a staging copy if the site is live. Our guide on how to set up a staging site for WordPress shows the safe way.

Steps for a conflict test:

  1. Switch to a default theme such as Twenty Twenty-Five
  2. Deactivate every plugin except WPML and its add-ons
  3. Check whether the switcher appears and works
  4. Reactivate plugins one at a time, testing after each

The Health Check and Troubleshooting plugin can run this test for your user only, so visitors still see the normal site.

Also update WPML, its add-ons, your theme and WordPress core. Older WPML versions sometimes clash with newer themes or block editor changes. WPML runs a compatibility program with many theme and plugin authors, so a fix may already exist.

Are some languages missing from the switcher?

Languages vanish from the switcher when they are not active, have no translation for that page, or are set to hidden in WPML.

Check these settings:

  • WPML > Languages > Site Languages lists every active language
  • The hidden languages option keeps a language visible only to logged-in admins
  • The skip language option drops languages with no translation from the list
  • The switcher may be set to hide the current language, so you see one fewer item than expected

Hidden languages are handy while you translate, but they confuse people later. If you forgot you hid a language, the switcher looks broken for every visitor.

How do you check the switcher works after the fix?

Test every language, page type and device in a private window after clearing all caches, because a switcher that works on one page can still fail on another.

A short test plan:

  1. Open the home page in each language and switch between all languages
  2. Repeat on a post, a page, a category archive and a product if you run WooCommerce
  3. Test on a phone, since mobile menus often use a separate template
  4. Test logged out, because admins can see hidden languages
  5. Check the URLs change to the correct language format

Write down any page where the switcher fails. A pattern, such as only archives or only mobile, points straight to the cause.

When should you contact WPML support?

Contact WPML support when the switcher still fails on a default theme with only WPML active, because that points to a bug or a configuration problem only their team can trace.

WPML includes support with paid accounts through its support forum. Before you post, gather:

  • Your WPML version and add-on versions
  • Your theme and page builder
  • The URL format you use
  • A list of what you already tried
  • Screenshots of WPML > Languages switcher settings

Debug information speeds things up. WPML has a support page in its menu that collects system details, and the WordPress debugging documentation shows how to log PHP errors that may point to the cause.

Frequently asked questions

Why does the WPML switcher only show in my default language?

WPML attaches the menu switcher to one menu. Your translated pages use a translated menu that either does not exist or is not assigned to the same theme location. Sync menus with WP Menus Sync, then assign each translated menu to the right location.

Why does clicking a language take me to the home page?

The page you are on has no published translation in that language. WPML then links to the home page of that language, or skips it, based on your switcher settings. Translate and publish the page to fix it.

How do I add the WPML switcher to an Elementor header?

Edit the header template in Elementor and add the WPML language switcher widget. This needs the WPML compatibility add-ons and String Translation active. A classic menu switcher may not appear inside a builder header.

Can a cache plugin break the WPML switcher?

Yes. If the cache stores one language version and serves it to everyone, the switcher seems to do nothing or flips back. Use directory or domain URL formats and clear the plugin, host and CDN caches.

Why is one language missing from the switcher?

The language may be hidden, inactive, or untranslated for that page. Check Site Languages and the hidden languages option in WPML settings, and see whether the switcher skips languages with no translation.

Sources

  1. Language switcher options WPML
  2. WPML OnTheGoSystems
  3. Health Check & Troubleshooting WordPress.org Plugins
  4. Debugging in WordPress WordPress Developer Resources
  5. Console overview Chrome for Developers

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.