Polylang > Blog > How to add a Language Switcher to your WordPress website?

How to add a Language Switcher to your WordPress website?

Marine Larmier

Polylang

1 January 1970

Looking for detailed instructions?

You can also visit our language switcher guide for detailed instructions on all the available options and settings.

Want to learn how to add a language switcher to your WordPress site? You’ve come to the right place. A language switcher (or language selector) is your website’s multilingual navigator, allowing visitors to effortlessly explore content in different languages. It empowers your international audience to be able to select their preferred language when they are browsing your site.

A language switcher is essential for every multilingual website, particularly for public services and companies located in countries with multiple national languages such as Canada or Switzerland. Additionally, it plays a crucial role for international brands, multilingual WooCommerce sites, and the hospitality industry. Just try to picture Airbnb without a language switcher – they’d miss out on many international bookings and end up with frustrated users unable to access listings in their own language.
Alright, it’s time to make your international audience happy with a functional language switcher. In this article, we show you four simple steps to add a language switcher to your WordPress site.


How to add a WordPress Language Switcher in a few steps?

1. Deciding the display location for your Language Switcher

The main navigation menu is usually the most popular place to have it, but we are also exploring a few other locations to keep your options open.

Display the Language Switcher in a classic navigation menu

The main idea here is to create one language switcher per menu and language. In our case, we have three languages: French, English, and Italian so we will need to create 3 menus and a language switcher for each of them.

  • Go to Appearance > Menus – You should see the option to add a Language switcher in the menu items.

⚠️ Are you not seeing the Menus option under Appearance? You may be using a Block theme. Jump directly to the Site Editor section.

Opening Appearance > Menus
Opening the Menus section to add a language switcher

Hint: if the language switcher is not showing in the menu, open the screen options at the top of the page and make sure the Language switcher box is checked.

Showing the Language Switcher option in Screen Options
Opening Screen Options to show the language switcher in the navigation menu
  • Check the Languages box and click on the Add to Menu button.
Adding the Language Switcher to a Classic Menu

Selecting the Language Switcher and adding it to the menu
  • From the Menu Settings section, rename your menu to your first language. Let’s start with French, which we call “My main Menu FR”.
Menu name field in the WordPress classic menu settings, renamed to “My main Menu FR”
Renaming a Classic Menu
  • From the Pages section, add all the French pages to the navigation menu.
French pages selected in the WordPress classic menu editor
Adding French Pages to a Classic Menu
  • From the Menu settings, select the location “Primary Menu Français”.
Primary Menu Français selected as the display location in the WordPress classic menu settings
Selecting the Primary Menu Français Location
  • That’s it! You now have a language switcher in your French navigation menu:
Dropdown language switcher displayed in the French navigation menu of a WordPress website
Language Switcher in the French Navigation Menu

Repeat the action for each language. Let’s see a short example for English.

  • In Appearance > Menu > Create a new menu. Rename it like we did “My main Menu EN”, add the language switcher and the English pages.
New English navigation menu in the WordPress classic menu editor, with the Language Switcher and English pages added
Creating a New English Classic Menu
  • Don’t forget to select the location by checking the Primary Menu English box:
Primary Menu English selected as the display location in the WordPress classic menu settings
Selecting the Primary Menu English Location

Repeat the same steps for all your other languages.

Display the Language Switcher in a Widget

To add a language switcher in a widget, go to Appearance > Widgets and click on the + icon to add the Language Switcher widget. You can choose to have it in the header, sidebar, or even the footer. We will select the Footer Bar Section 1 location.

Language Switcher widget being added in the WordPress Widgets editor
Adding a language switcher from the Widgets section

You’ll find the exact same options explained previously, with an additional one: “The widget is displayed for” – which aims at specifying the language for which the switcher should be displayed.

“The widget is displayed for” setting with language options in the WordPress Language Switcher widget settings
“The widget is displayed for” options for each language

Display the Language Switcher in the Footer with Links

If you want to add a basic language switcher with links in your Footer, you can also do it from the WordPress Customizer.

  • Go to the Footer Builder section. From there you can add a widget anywhere in the footer:
WordPress Customizer Footer Builder showing a widget being added to a footer section
Adding a widget to the footer
  • Select the Language switcher widget and choose the options you want:
Language Switcher widget settings displayed in the WordPress Customizer
Language Switcher widget from the Customizer
  • Check the Display language names box.
Display language names option enabled in the WordPress Language Switcher widget settings
“Displays language names” option
  • You are all set! You now have a language switcher with links in your footer:
Language switcher with language name links displayed in the footer on the front end of a WordPress website
Language Switcher with Links in the Footer

Display the language switcher in a block theme

With block themes, Polylang offers several ways to add a language switcher, depending on where you want it to appear and which editor you use.

Where do you want to add it?PolylangPolylang ProPolylang Business Pack
In the Widgets block editor (Appearance > Widgets)✓✓✓
As a block in the WordPress Block Editor✓✓✓
Inside a Navigation block✓✓✓
In the Site Editor navigation (Appearance > Editor)–✓✓

2. Configure the Language Switcher

The available display options depend on the type of language switcher you use. Some options are specific to classic menus, widgets, or blocks.

Language Switcher typeAvailable layoutsAdditional options
Classic navigation menuInline, DropdownLanguage names, language codes, flags, flag aspect ratio
Classic widgetHorizontal, Vertical, Dropdown, SelectorAlignment, labels, flags, flag aspect ratio
Standard block (Block Editor and Widgets)Horizontal, Vertical, Dropdown, SelectorAlignment, labels, flags, flag aspect ratio, border radius, flag size, label spacing
Navigation Language Switcher blockHorizontal, DropdownLanguage names, language codes, flags, flag aspect ratio, border radius, flag size, label spacing

For a detailed comparison of all available options, see our Language Switcher documentation.

Here are few examples of some options:

  • Displays as a dropdown: Allows users to select their preferred language from a list. If you don’t check those options, the languages will be simply displayed side-by-side in the navigation menu.
Displays as a dropdown Displays all languages side-by-side in the menu
  • Hides the current language: Hides the language that is currently in use on the website, contributing to a cleaner and more streamlined selector. That’s how to hide the current language. In a few clicks, we improved our language switcher by making it more straightforward for our international visitors.
Language switcher by defaultCustomized language switcher: English hidden from the dropdown when some English content is displayed. 

3. Customizing Language Order, Names, and Flags

How to change the language order In Polylang Language Switcher

You can change the language order in the language switcher directly from your WordPress dashboard.

  • Head to Languages > Languages >Click on Edit under the language of your choice.

The Edit button from the Languages section

  • Scroll down to the Order field > Add a number to change the position of the language in the switcher.

Field to change the order of languages in the language switcher

French was first French is now the last  

How to Change the Language Name In Polylang Language Switcher.

You can customize how language names are displayed in your language switcher using the Display labels option:

  • Language names: Display the full language names (e.g. English, Français).
  • Language codes: Display language codes instead (e.g. EN, FR).
  • None: Display flags without any text labels.

To change the full name of a language, go to Languages > Languages, click Edit under the language of your choice, and update the Full name field.

Field to change the name of languages in the language switcher

How to add custom flags in Polylang Language Switcher

While Polylang offers flags by default, you can also add your custom flags in JPG, PNG, and SVG. Follow the steps below to make sure your flags will be properly displayed:

  • Properly name the file using the WordPress locale available from Languages > Languages > Languages list table > the Locale column.

For example, if you want to upload a custom British flag, you’ll have to name it “en_GB”.

  • Upload the custom flags files in the /wp-content/polylang/ directory. Feel free to create it if it’s not there.
Hint: Avoid using the /wp-content/plugins/polylang/flags/ directory as your files will be removed upon the next update of the plugin.

Locale name that must match the custom flag file name

  • Head to Languages > Settings sub-menu and click on Settings under the URL modifications tab to expand it.

Settings section to confirm the changes in flags

  1. Click on the Save Changes button.
  2. Your new flags will appear on the front end.

Want to dive deeper? There is a full documentation available that explains in detail how to add custom flags to the language switcher with Polylang.

Now that you’re more familiar with Polylang and the different ways of adding a language switcher to your site. Get some inspiration from the best practices outlined in the next section.

Displaying Language Switcher Best Practices

Without any surprises, language switchers play a crucial role in providing a positive user experience for multilingual websites. Here are some best practices to follow when implementing language switchers:

Make sure the Language Switcher is easily accessible to users

If you aim to broaden your digital reach across borders effectively, ensure your language switcher is prominently displayed. It should be visible and accessible from anywhere on your website. Place it in a consistent location, such as the header or footer, so users know where to find it.

Did you know that 76% of online shoppers prefer buying products with information in their native language? Maximize sales by making sure your language switcher is visible.

Design a Language Switcher that is both functional and aligned with your site’s design

Design the language switcher to be consistent with the overall look and feel of your website. Ensure that it complements your site’s color scheme and style as design consistency is key.

Select only relevant languages for your audience

Avoid overwhelming users with a long list of languages, especially if they are unlikely to be used. Prioritize the most important languages and arrange them from the most visited to the least. Check your analytics to identify the source of your traffic and reorganize the dropdown menu accordingly.


Always use language names

Display language names clearly and understandably. Avoid using flags alone, as they may not be universally understood, and some users may find them confusing. That’s the case for the Portuguese language spoken in Portugal and Brazil, always add the name of the language near the flag so users know what to expect.

WordPress Website examples using our Language Switcher

Polylang has more than 800,000 active installations but we have selected three inspiring examples to show you several types of language switchers built with our plugin.

Massmailsoftware is an international company specializing in software development, sales, marketing, and support. They are recognized as a Microsoft-certified partner, showcasing their commitment to excellence in technology and software solutions.

In their language switcher, they have one language, English, and two countries: Nigeria, and India, with custom-rounded flags. What makes it interesting is that they have used Polylang to target different countries, not languages (it’s kind of a multisite).




A Language Switcher displaying one language on a WooCommerce site

GoudronBlanc is a French online store using the WooCommerce platform to sell high-quality t-shirts. They translated their site from French to English to get more international customers.

In their language switcher, they are using the “Hide the current language” feature, meaning that when users browse in English, they’ll only see the French button.

Client Project #3 – A Dropdown Language Switcher

Webib is a robust web agency specializing in website development, design, UX, and SMM from Tallinn, Estonia. Their site is available in 3 languages: English, Russian, and Estonian, allowing them to get more international projects. The language switcher is a dropdown menu which is perfect for a trilingual site.

Wrapping Up

Polylang stands out as one of the most convenient methods to add a language switcher anywhere on your WordPress site. You can have it in the header, in the navigation menu, in a widget, in a block, and even in the footer. Why not give Polylang a try? The best part is that you can achieve any parts of this tutorial for free, absolutely no risks taken, right? Download Polylang, translate your WordPress site, and add a language switcher to ensure seamless navigation for your international visitors!

If you are experiencing any issues on your WordPress site, we encourage you to visit our language switcher documentation.

Author

Marine Larmier

Creative copywriter and translator with 10+ years of experience creating content for WordPress, the United Nations, and private companies worldwide. Now based between France and New Zealand, I’m passionate about languages, yoga, sunsets, and world cuisine.