Troubleshooting
Polylang Language Switcher Not Working: Causes and How to Fix It

Short answer
The Polylang language switcher usually stops working because it was not added to a visible menu, widget or block, the menu is not assigned for every language, pages have no linked translations, or a cache serves one language to everyone. Fix placement first, then translations, then caching.
Key takeaways
- Polylang only shows the switcher where you place it.
- Each language needs its own menu assigned in Manage Locations.
- Block themes need the Language switcher block inside the Navigation block.
- Links go to the home page when the current page has no translation.
- Clear caches and flush permalinks after changing URL settings.
Why is the Polylang language switcher not working?
The Polylang switcher usually fails because it was never added to a visible location, the menu is not assigned for every language, pages lack translations, or a cache serves the wrong language.
Polylang does not add a switcher to your site automatically. You choose where it goes: a menu, a widget area, a block or your theme code. Many not working reports are really not placed or placed in a menu that is not shown.
Common symptoms:
- The switcher does not appear at all
- It shows in one language but not the other
- Clicking a flag goes to the home page instead of the translated page
- Flags are missing or broken
- The switcher changes language once, then switches back
Work through the sections below in order. Each one rules out a common cause.
Did you add the switcher in the right place?
Add the switcher through Appearance > Menus, a Language switcher widget or block, or a navigation block, because Polylang only shows it where you put it.
There are four main ways to place it:
| Method | Where | Best for |
|---|---|---|
| Menu item | Appearance > Menus | Classic themes with menus |
| Widget | Appearance > Widgets | Sidebars and footers |
| Block | Block editor or Site Editor | Block themes and page content |
| Theme function | Template files | Custom theme work |
Menu. In Appearance > Menus, open Screen Options and tick Language switcher if the box is hidden. Add it to your menu, then set its display options, such as flags, names or dropdown.
Widget or block. Add the Language switcher widget to a widget area, or the Language switcher block where you want it.
Theme code. Developers can call the pll_the_languages function in a template. Wrap it in a check that Polylang is active so the site does not break if the plugin is turned off.
Is your menu assigned for every language?
Polylang creates a menu location for each language, so a switcher added to the English menu will not appear on French pages unless the French menu has it too.
Go to Appearance > Menus and open Manage Locations. You will see each theme location listed once per language, such as Primary Menu English and Primary Menu French.
Fix it in three steps:
- Create or pick a menu for each language
- Add the Language switcher item to each menu
- Assign each menu to the matching language location
This is the single most common reason the switcher shows in one language only. Our guide on how to use the Polylang plugin covers menu setup in more detail.
Does your block theme need a different method?
Block themes do not use the classic Menus screen, so add the Language switcher block inside the Navigation block in the Site Editor.
Open Appearance > Editor, edit the header template part, select the Navigation block, and add the Language switcher block inside it. Save the template part.
WordPress's guide to the Navigation block explains how navigation menus work in block themes. If you do not see the Language switcher block, update Polylang, since block support has been added and improved over time.
If you cannot add it inside the navigation, place the block next to the Navigation block in a Row block. It will look like part of the header.
Why does the switcher send visitors to the home page?
The switcher links to the home page of the other language when the current page has no translation, so create and link the missing translation.
Open the page in the editor and look at the Languages box. Each language shows either a link to its translation or a plus icon to create one. A plus icon means there is no translation yet.
Polylang's switcher settings include Hides languages with no translation. Turn it on if you prefer to hide the flag instead of linking to the home page.
Also check posts that you translated by duplicating them manually. If the two posts are not linked in the Languages box, Polylang treats them as unrelated.
Could URL settings break the switcher?
Yes, wrong URL modification settings or stale permalinks can make switcher links point to 404 pages or stay on the same language.
Polylang's URL settings live under Languages > Settings. You can set the language from the content, a directory such as /fr/, subdomains or separate domains.
After changing these settings, flush your permalinks. Go to Settings > Permalinks and click Save Changes without editing anything. Our guide on how to flush permalinks in WordPress explains why this helps.
Subdomain and separate-domain setups need DNS and server configuration too. If those are incomplete, switcher links will lead to errors even though Polylang is set up correctly.
Could caching make the switcher show the wrong language?
Yes, page caches and CDNs can serve one language's cached page to everyone, so the switcher appears stuck or flips back after clicking.
Polylang uses a cookie named pll_language to remember a visitor's choice. Some caching setups ignore it, so a visitor asking for French gets a cached English page.
Fixes that usually help:
- Use a language directory or subdomain so every language has its own URL
- Clear your caching plugin, host cache and CDN after changes
- Check your caching plugin's notes on multilingual sites
- Exclude the language cookie from cache rules if your setup relies on it
Our guide on how to clear cache in WordPress shows where each cache lives.
Why are flags missing or broken?
Flags disappear when the display option is off, a theme or optimizer blocks the images, or a custom CSS rule hides them.
Open the switcher's settings in the menu, widget or block and confirm Displays flags is ticked. If you only see language names, that is the setting.
Next, check performance plugins. Lazy-loading or image optimization can break small inline flag images. Exclude the switcher from lazy loading and test again.
If flags show in the admin but not the front end, inspect the switcher with your browser's developer tools. A CSS rule such as display none on images in the menu is a common cause.
Why is the switcher missing from an Elementor header?
Elementor headers do not use your theme's menu locations, so add the switcher with an Elementor menu that includes it, a widget, or a compatible add-on.
If your Elementor header uses the Nav Menu widget, pick the menu that contains the Language switcher item. You need one menu per language, and the header template needs a translation for each language.
Some site owners use a third-party add-on that provides a Polylang switcher widget for Elementor. Check reviews and update history before installing one. Our guide on whether Polylang works with Elementor covers the options.
How do you rule out a plugin or theme conflict?
Switch to a default theme and deactivate other plugins on a staging copy; if the switcher works, turn things back on one by one to find the conflict.
Conflicts often come from other translation plugins, menu plugins and heavy theme frameworks. Never run two multilingual plugins at once.
Turn on the WordPress debug log while testing. The debugging guide on WordPress Developer Resources shows how. PHP errors that mention Polylang or your theme point straight to the cause.
If nothing here fixes it, search the Polylang support forum on WordPress.org or contact Polylang support if you have the Pro version. Include your theme, Polylang version and URL settings.
Frequently asked questions
Why does the Polylang switcher only show in one language?
Polylang creates a separate menu location for each language. You added the switcher to one language's menu only. Add it to a menu for every language and assign each menu in Manage Locations.
How do I add the Polylang switcher to a block theme?
Open the Site Editor, edit your header template part, select the Navigation block, and add the Language switcher block inside it. Save the template part and check the header in each language.
Why does clicking a flag go to the home page?
The page you are on has no linked translation in that language, so Polylang falls back to the home page. Create the translation, or enable the option that hides languages with no translation.
Does Polylang have a switcher shortcode?
The free plugin does not ship a general shortcode. You can use the menu item, widget, block or the pll_the_languages function in theme code. Some add-ons provide shortcodes, but check their quality first.
Why does my site switch back to the default language?
A cache is often serving the default language page. Use language directories or subdomains so each language has its own URL, then clear your caching plugin, host cache and CDN.
Sources
- Polylang plugin WordPress.org Plugins
- Polylang WP SYNTEX
- Navigation block WordPress.org Documentation
- Using HTTP cookies MDN Web Docs
- Debugging in WordPress WordPress Developer Resources
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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


