Plugin how-tos · Guide
How to Install Polylang in WordPress (Step by Step)

Short answer
Go to Plugins > Add New Plugin, search for Polylang, then install and activate the plugin by WP SYNTEX. Run the setup wizard to add your languages and assign existing content to your default language. Then choose your URL format under Languages > Settings.
Key takeaways
- Polylang is free in the plugin directory, with a paid Pro version.
- The setup wizard adds languages and assigns existing content to the default language.
- Pick your URL format, such as directory or subdomain, before publishing translations.
- Each translation is a separate post linked to the original.
- Add a language switcher and a menu for each language.
- Do not run Polylang alongside another multilingual plugin.
What is Polylang and what do you need to install it?
Polylang is a free multilingual plugin that lets you write posts, pages and menus in several languages; you need admin access and a backup before installing it.
Polylang works differently from automatic translation tools. It does not translate your text for you. Instead, it lets you create a separate version of each post or page in each language and links them together.
The free version is listed in the WordPress.org plugin directory. A paid version, Polylang Pro, adds features such as shared slugs and translation of custom post type slugs.
Before you install it, check:
- You are an administrator on the site.
- You have a recent backup, especially on a live site with content.
- No other multilingual plugin is active. Running WPML or TranslatePress alongside Polylang causes conflicts.
- You know your languages. Decide your default language and the others you will add.
If you are still choosing a plugin, compare Polylang with WPML and other options before you commit, since switching later takes work.
How do you install Polylang from the WordPress dashboard?
Go to Plugins > Add New Plugin, search for Polylang, click Install Now on the plugin by WP SYNTEX, then click Activate.
Step by step:
- Log in to your WordPress dashboard.
- Go to Plugins > Add New Plugin.
- Type Polylang in the search box.
- Find the plugin by WP SYNTEX. Check the author name, since other plugins use similar names.
- Click Install Now.
- Click Activate once the install finishes.
After activation, Polylang usually opens its setup wizard. If it does not, you will find a new Languages menu in the dashboard sidebar.
The WordPress documentation on managing plugins explains the plugin screens if you are new to them.
How do you complete the Polylang setup wizard?
The wizard walks you through adding languages, deciding on media translation, assigning existing content to your default language, and finishing setup in a few screens.
Polylang documents each screen in its setup wizard guide. Here is what to expect:
- Languages. Choose a language from the dropdown and click Add new language. Repeat for each language. The first one you add becomes the default.
- Media. Decide whether to translate media. Turning it on lets you write alt text and captions in each language.
- Content. If your site already has posts and pages, the wizard assigns them to your default language. Accept this, or existing content will have no language.
- Ready. The wizard confirms setup and links to documentation.
You can skip the wizard and set up everything under Languages later. But on a site with existing content, running the wizard saves a step.
Adding a language also downloads the matching WordPress translation files, so the admin area and theme strings can appear in that language too.
How do you add or edit languages after setup?
Go to Languages > Languages, pick a language from the list, adjust its details if needed, and click Add new language; existing languages can be edited from the same screen.
Each language has a few fields:
| Field | What it controls |
|---|---|
| Full name | The name shown in the language switcher |
| Locale | The WordPress locale, such as en_US or fr_FR |
| Language code | The short code used in URLs, such as en or fr |
| Text direction | Left to right or right to left |
| Flag | The flag shown next to the language |
| Order | Position in the switcher |
Most people only pick the language from the dropdown, which fills in the rest. Change the language code only if you have a reason, because it appears in your URLs.
To change your default language later, click the star icon next to the language you want in the list. Do this early, before you build a lot of content.
How do you choose how Polylang shows languages in URLs?
Go to Languages > Settings and open URL modifications, then choose whether the language comes from the content, a directory name, a subdomain or separate domains.
This setting affects SEO and how your links look, so pick it before you publish translations:
| Option | Example URL | Good for |
|---|---|---|
| Directory name | example.com/fr/about | Most sites, easy to set up |
| Subdomain | fr.example.com/about | Sites that want separate sections per language |
| Separate domains | example.fr/about | Sites targeting countries with their own domains |
| Set from content | example.com/about | Simple setups, but less clear for search engines |
The directory option is the most common choice. Subdomains and separate domains need DNS and SSL set up for each address.
There is also an option to hide the language code for the default language. That keeps your existing URLs unchanged, which helps if your site already ranks.
After saving, visit Settings > Permalinks and click Save Changes once to refresh URL rules.
How do you translate a post or page with Polylang?
Open the post in the editor, find the Languages panel, click the plus icon next to the target language, and write the translation in the new draft that opens.
The process:
- Go to Posts or Pages and open the original.
- Look for the Languages box in the editor sidebar.
- Click the + icon next to the language you want.
- WordPress opens a new draft linked to the original.
- Write or paste the translated content and publish it.
In the posts list, Polylang adds a column per language. A pencil means a translation exists, and a plus means it does not yet.
Categories and tags work the same way. Translate them under Posts > Categories and Posts > Tags, using the language columns.
For theme text like button labels, go to Languages > Translations. That screen lists strings registered by your theme and plugins. To translate plugin text files instead, see our guide on translating a WordPress plugin.
How do you add a language switcher and translate menus?
Add the language switcher block or widget where you want it, and create a separate menu for each language under Appearance > Menus or the Site Editor.
For classic themes:
- Go to Appearance > Menus.
- Create a menu for each language and assign each one to the theme location for that language.
- Add the Language switcher item from the left panel to show language links in the menu.
For block themes, add the Polylang language switcher block in the Site Editor, usually in the header.
If the switcher does not show up or links to the wrong page, our guide on the Polylang language switcher not working walks through the usual fixes.
How do you install Polylang Pro instead?
Download the Polylang Pro zip from your account on the vendor's site, deactivate the free Polylang plugin, then upload and activate Pro and enter your license key.
Polylang Pro includes everything in the free plugin, so you do not run both at the same time. Your languages and translations stay in the database, so Pro picks them up after the switch.
- Download the Pro zip from your account.
- Go to Plugins and deactivate Polylang. Do not delete it with data removal options turned on.
- Go to Plugins > Add New Plugin > Upload Plugin and upload the Pro zip.
- Activate Polylang Pro.
- Enter your license key under Languages > Settings in the licenses area.
Check the Polylang documentation for current Pro features and the license screen location, since these can change between versions.
What should you check after installing Polylang?
Visit the site in each language, test the switcher, check that URLs include the right language code, and confirm your SEO plugin outputs hreflang tags.
A short checklist:
- Front end. Switch languages and confirm each page shows the right content.
- Home page. If you use a static front page, Polylang needs a translated version of it in each language.
- Caching. Clear your cache plugin and CDN after setup.
- SEO. Most major SEO plugins support Polylang. Check that hreflang tags appear in the page source, as described in Google's guide to localized versions of pages.
- Page builders. If you use Elementor, read our guide on whether Polylang works with Elementor.
Once the basics work, our guide on using the Polylang plugin covers daily workflows like string translation and syncing.
What are common Polylang installation problems?
Common problems include pages returning 404 after setup, content with no language assigned, and conflicts with caching or another multilingual plugin.
| Problem | Fix |
|---|---|
| Translated pages show 404 | Resave Settings > Permalinks |
| Old posts missing from lists | Assign them to the default language |
| Wrong language on home page | Translate the static front page |
| Switcher missing | Add the block, widget or menu item |
| Odd behavior everywhere | Deactivate other multilingual plugins |
If the site breaks after activation, use the recovery mode email or rename the polylang folder in wp-content/plugins with an FTP client such as FileZilla. Then look for the conflicting plugin before trying again.
Frequently asked questions
Is Polylang free?
Yes, the core Polylang plugin is free in the WordPress plugin directory and covers translating posts, pages, categories, tags and menus. Polylang Pro is a paid version with extra features. Check the vendor's pricing page for current plans and what each includes.
Does Polylang translate content automatically?
No. Polylang gives you the structure to manage each language, but you write or paste the translations yourself. Automatic machine translation needs a separate paid service or add-on. Check the vendor's site for current automatic translation options.
Can I install Polylang on a site with existing content?
Yes. The setup wizard offers to assign all existing posts, pages and terms to your default language. Accept it, otherwise older content will have no language and may disappear from filtered lists until you assign one.
Will Polylang slow down my site?
Polylang is fairly light because it stores translations as normal posts. Most sites see little change. Use a caching plugin that supports multilingual setups, and avoid running extra translation plugins you do not need.
How do I remove Polylang later?
Deactivate and delete it from the Plugins screen. Your translated posts stay as separate posts, but the links between languages and the language URLs stop working. Back up first and plan redirects for the old language URLs.
Sources
- Polylang plugin WordPress.org
- Setup wizard Polylang
- Polylang documentation Polylang
- Manage Plugins WordPress.org
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.


