Plugin how-tos · Guide
How to Use Polylang Plugin in WordPress: A Beginner's Guide

Short answer
Install Polylang, add your languages under Languages and pick a default. Choose a URL format in Languages > Settings, then create linked translations of posts, pages, categories and menus using the plus icons in each list. Translate site strings in Languages > Translations and add a language switcher to your menu or a widget area.
Key takeaways
- Polylang links separate posts and pages as translations of each other.
- The free version manages translations but does not translate text automatically.
- Choose directories, subdomains or separate domains for language URLs.
- Translate site strings such as the title and tagline in Languages > Translations.
- Polylang adds hreflang tags; check sitemaps and SEO titles in every language.
How do you use the Polylang plugin in WordPress?
Install Polylang, add your languages under Languages, set a default language, then create a translation of each post, page, category and menu, and add a language switcher so visitors can change language.
Polylang is a free multilingual plugin with a long track record on the WordPress plugin directory. It does not translate text for you in the free version. You, or a translator, write each translation, and Polylang links the versions together.
Each translation is a normal WordPress post or page tied to a language. That makes Polylang lightweight and easy to understand.
If you only need the dashboard in another language, that is a different task. Our guide on changing the WordPress language covers it.
What do you need before you start?
You need admin access, a backup, a clear list of target languages, and translated content or a plan for who will write it, because Polylang free manages translations but does not create them.
Plan these points first:
- Which languages you will offer, and which is the default
- Whether URLs will use folders, subdomains or separate domains
- Who will translate pages, posts, menus and theme strings
- Whether you run WooCommerce, which needs an extra add-on for full support
Starting with a staging copy is wise on an existing site. Adding languages changes URLs, and you want to check redirects and SEO before going live.
If your site runs a store, read our guide on building a WooCommerce website alongside this one, since store pages need extra translation work.
How do you install and set up Polylang?
Go to Plugins > Add New, search for Polylang, install and activate it, then follow the setup wizard to add languages, choose a default, and assign existing content to that language.
- Go to Plugins > Add New
- Search for Polylang and click Install Now
- Click Activate
- Follow the wizard, or go to Languages > Languages if you skip it
- Add your first language, which becomes the default
- Add your other languages
- Let Polylang assign existing posts, pages and terms to the default language
The language list includes a locale code, such as en_US or fr_FR, which controls the translation files WordPress loads. Polylang usually downloads available WordPress core translations automatically.
You can change the default language later by clicking the star next to a language in the list.
How do you choose the URL structure?
Go to Languages > Settings and open URL modifications, then choose whether the language comes from the content, a directory such as /fr/, a subdomain, or a different domain per language.
| Option | Example | Notes |
|---|---|---|
| Directory | example.com/fr/ | Most common and easy to manage |
| Subdomain | fr.example.com | Needs DNS and SSL for each subdomain |
| Separate domains | example.fr | Needs each domain pointed to the site |
| Language set from content | Query parameter style | Simplest, but less clear for visitors |
The directory option suits most sites. It keeps everything on one domain and is straightforward to set up.
You can also hide the language code for the default language, so existing URLs stay the same. That helps protect rankings when you add languages to an established site.
Google's guide to managing multi-regional and multilingual sites explains how each URL approach affects search.
How do you translate posts and pages?
In Posts or Pages, click the plus icon in a language column next to the item, or open the item and use the Languages panel in the editor, to create a linked translation, then write the translated content.
- Go to Pages > All Pages
- Find the language columns, each shown with a flag
- Click the plus icon under the target language for a page
- Write the translated title and content
- Publish the translation
The pencil icon edits an existing translation. Once linked, Polylang knows these pages are versions of each other and points the language switcher to the right one.
Polylang can copy some data across translations, such as featured images, taxonomies and custom fields, depending on the synchronization options in Languages > Settings.
For a store or a large site, translating by hand takes time. Our guide on translating WordPress with AI looks at faster options and their limits.
How do you translate categories, tags and menus?
Translate categories and tags under Posts > Categories and Posts > Tags using the same plus icons, and in classic themes create a separate menu for each language under Appearance > Menus.
Terms work like posts. Each category gets a linked translation per language. Posts should be assigned to categories in the same language.
For menus in a classic theme, Polylang creates a menu location for each language. Build a menu for each language and assign it to the matching location.
Block themes use the Navigation block, and multilingual menu handling there depends on your Polylang version. Check the Polylang documentation for the current approach with the Site Editor.
How do you translate site title, tagline and widget text?
Go to Languages > Translations, which lists strings such as the site title, tagline, date format and widget titles, then enter the translation for each language and save.
These strings are not posts, so they need their own screen. Some themes and plugins register extra strings here too.
If a piece of text from a theme or plugin does not appear in the list, it is usually translated through that plugin's language files instead. Our guide on translating a WordPress plugin covers that method.
How do you add a language switcher?
Add the language switcher as a menu item under Appearance > Menus, as a widget, or as a block, then choose options such as showing flags, language names or hiding the current language.
- For a classic menu, go to Appearance > Menus
- Find the Language switcher box on the left and add it to your menu
- Choose display options, such as flags and names
- Save the menu
For widget areas, add the Language switcher widget or block. In block-based layouts, use the switcher block if your version provides one.
Using language names rather than only flags is better for usability, because flags represent countries, not languages. The W3C's article on language negotiation and switchers discusses why.
How does Polylang handle SEO?
Polylang adds hreflang tags that tell search engines which pages are translations of each other, sets the HTML lang attribute, and works with popular SEO plugins for translated titles and sitemaps.
Hreflang helps Google show the right language version to each searcher. Google's hreflang documentation explains the rules.
- Write a unique SEO title and meta description for each translation
- Translate the slug, so URLs match the language
- Check that your XML sitemap includes all languages
- Do not auto-redirect visitors based on browser language without letting them switch back
Polylang's integration with SEO plugins such as Yoast SEO and Rank Math varies by version, so test your sitemaps after setup.
What are the limits of Polylang free?
Polylang free has no machine translation, limited WooCommerce support, and fewer workflow tools than Polylang Pro, which adds features such as shared slugs, translation duplication and machine translation integration.
| Need | Polylang free | Paid option |
|---|---|---|
| Manual translation of posts, pages, terms | Yes | Also in Pro |
| Language switcher and hreflang | Yes | Also in Pro |
| Machine translation | No | Polylang Pro integrations |
| WooCommerce products, cart and checkout | Limited | Polylang for WooCommerce add-on |
| Same slug in several languages | No | Pro |
Check the official site for current prices and features before buying. Free is enough for many brochure sites with a few languages.
What should you check after setting up Polylang?
Visit every language version, test the switcher on each page type, confirm menus and widgets change language, and check that translated pages are indexed correctly.
- Switch language on the homepage, a post, a page and an archive
- Confirm untranslated pages do not show broken switcher links
- Check forms, emails and checkout text in each language
- Look in Google Search Console for hreflang or indexing errors after launch
If new language pages are slow to appear in search, our guide on getting WordPress pages indexed faster can help. Then keep translations in sync whenever you update the default language content.
Frequently asked questions
Is Polylang free?
Yes, the core Polylang plugin is free on the WordPress plugin directory and covers languages, linked translations, string translations, a language switcher and hreflang. Polylang Pro and Polylang for WooCommerce are paid add-ons with extra features.
Does Polylang translate content automatically?
Not in the free version. You write each translation yourself or paste in text from a translator or tool. Machine translation integration is offered in the paid Pro version, so check the vendor page for current details.
Can I use Polylang with WooCommerce?
You can translate some content, but full support for products, cart, checkout and emails needs the paid Polylang for WooCommerce add-on. Test the whole purchase flow in every language before launch.
Will Polylang change my existing URLs?
It can, depending on your URL settings. Hiding the language code for the default language keeps existing URLs the same, which is the safest option when adding languages to an established site.
Is Polylang better than WPML?
Both are mature. Polylang free suits smaller sites with manual translation, while WPML is paid and includes more translation management tools. The best choice depends on budget, store needs and how you translate.
Sources
- Polylang WordPress.org Plugins
- Polylang Documentation Polylang
- Managing multi-regional and multilingual sites Google Search Central
- Tell Google about localized versions of your page Google Search Central
- Using language negotiation W3C Internationalization
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.


