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

Short answer
Download WPML from your account on its website, upload and activate it, then run the setup wizard to choose languages, a URL format and a translation mode. After that, translate posts, menus and theme text, and add a language switcher so visitors can change language.
Key takeaways
- WPML is a premium plugin bought on wpml.org, not the free plugin directory.
- The setup wizard handles languages, URL format, site key and translation mode.
- Language directories are the simplest URL format for most sites.
- String Translation covers theme, plugin and widget text.
- WooCommerce stores need the WooCommerce Multilingual add-on.
How do you use the WPML plugin in WordPress?
Install WPML from your wpml.org account, run its setup wizard to choose languages and URL format, register the site, pick a translation mode, then translate content and add a language switcher.
WPML is a premium plugin that turns one WordPress site into a multilingual site. Each translation is a real page with its own URL, which helps both visitors and search engines.
The basic workflow looks like this:
- Buy a WPML plan and download the plugin.
- Install and activate it.
- Run the setup wizard.
- Translate posts, pages, menus and theme text.
- Add a language switcher.
- Check translated URLs and SEO settings.
WPML's own getting started guide covers each stage. This beginner guide explains the steps and the choices that matter most.
Which WPML plan do you need?
Pick the plan based on whether you need theme and plugin text translation, page builder support and how many sites you run.
WPML is not on the free WordPress.org directory. You buy it on wpml.org. The plans have historically been:
- Multilingual Blog. Basic translation for simple blogs.
- Multilingual CMS. Adds string translation, page builder support, WooCommerce support and translation management.
- Multilingual Agency. Similar features for many more sites.
Most business sites and stores need the CMS level or higher, because the cheapest plan does not translate theme and plugin text. Prices and features change, so compare the current plans on the WPML site before buying.
If you want a free option instead, our guide on how to use the Polylang plugin covers a popular alternative.
How do you install WPML?
Download the WPML plugin zip from your wpml.org account, upload it under Plugins > Add New Plugin > Upload Plugin, and activate it.
Before you start, take a full backup. Our guide to backing up a WordPress site shows how.
Then:
- Log in to your account on wpml.org.
- Go to the downloads area and download the main WPML plugin.
- In WordPress, go to Plugins > Add New Plugin.
- Click Upload Plugin and choose the zip file.
- Click Install Now, then Activate.
WPML may offer to install add-ons later, such as String Translation or WooCommerce Multilingual. Install only the ones you need.
It is a good idea to set WPML up on a staging copy first if your site is busy. Our guide on setting up a staging site explains how.
How do you complete the WPML setup wizard?
The wizard asks for your default and translation languages, URL format, site key, translation mode and who will translate.
WPML documents every screen in its setup wizard guide. The main steps are:
- Languages. Choose the language your content is written in now, then the languages you want to add.
- URL format. Choose how translated addresses look.
- Registration. Paste the site key from your wpml.org account so updates and automatic translation work.
- Translation mode. Choose whether WPML translates everything automatically or only what you pick.
- Plugins and support. WPML may suggest extra components based on your theme and plugins.
Set your default language carefully. It should match the language your existing content is in. Changing it later is possible but messy.
You also choose who translates during the wizard. Options include you alone, other users on your site, or an outside translation service. You can change this later under Translation Management, so a simple choice is fine to start.
Which URL format should you choose in WPML?
Language directories, such as example.com/fr/, are the simplest and most common choice for most sites.
| URL format | Example | Good for |
|---|---|---|
| Language directories | example.com/fr/ | Most sites, easy setup |
| Separate domain per language | example.fr | Strong local branding |
| Language as a parameter | example.com/?lang=fr | Rarely recommended |
Directories keep everything on one domain and one SSL certificate. Separate domains need each domain pointed to the same site and an SSL certificate for each.
Directories also keep all your backlinks and domain authority in one place. That is usually the strongest choice for a small or medium site.
Whatever you choose, WPML adds hreflang tags so search engines know which page is which language. Google explains hreflang in its guide to localized versions of pages.
How do you translate pages and posts with WPML?
Open any post, click the plus icon for a language in the WPML language box, and translate the content in WPML's translation editor or let automatic translation fill it in.
If you chose automatic translation for everything, WPML translates new and updated content in the background. You can review it afterwards.
If you chose to translate only some content, the steps are:
- Edit a page or post.
- Find the Language box in the sidebar.
- Click the plus icon next to the language you want.
- Translate the text in the Advanced Translation Editor.
- Mark the translation complete and save.
You can also send many pages at once from WPML > Translation Management. That screen shows the status of every item.
Review automatic translations before you rely on them. Product names, legal text and brand terms are easy for machines to get wrong. WPML has a glossary feature that helps keep key terms consistent.
When you update the original page, WPML marks the translation as needing an update. Look for the refresh icon in the language box and send the page for translation again.
Automatic translation uses credits.
Each plan has historically included some, and you can buy more. Check your credit balance in your WPML account. Our guide on translating WordPress with AI compares machine translation choices.
How do you translate menus, widgets and theme text?
Use WPML's menu sync to copy menus across languages and String Translation to translate text that lives in your theme, plugins and widgets.
Menus are separate for each language in WPML. Go to WPML > WP Menus Sync to create matching menus based on your translated pages.
Text such as button labels, footer notes and form messages often comes from the theme or a plugin. WPML's String Translation module finds this text so you can translate it. Our guide on translating a WordPress plugin explains how this kind of text works in WordPress.
WordPress itself handles text in code through the internationalization APIs, which is what WPML hooks into.
How do you add a WPML language switcher?
Go to WPML > Languages and add a switcher to a menu, a widget area or the footer, then choose whether to show flags, native names or both.
WPML offers three common placements:
- Menu switcher. Adds languages as items in your main menu.
- Widget or block switcher. Places a switcher in a sidebar or any block area.
- Footer switcher. Shows a row of languages at the bottom of every page.
Show native names, such as Deutsch or Español, so visitors recognize their own language. Flags alone can confuse people, because one language may be spoken in many countries.
Place the switcher where people expect it, usually the top right of the header. Visitors who land on the wrong language look there first.
How do you use WPML with WooCommerce?
Install the WooCommerce Multilingual add-on, which lets WPML translate products, categories, attributes, cart and checkout pages, and email texts.
The add-on is listed on WordPress.org as WooCommerce Multilingual & Multicurrency. It needs the main WPML plugin to translate store content.
It can also show prices in different currencies. If that is your main goal, see our guide on setting up multi-currency in WooCommerce.
What should you check after setting up WPML?
Check every language version in a private window, confirm translated URLs work, test the language switcher and clear your caches.
A short checklist:
If something looks wrong, WPML > Support includes a troubleshooting area with tools to fix common sync issues. Run those only after you have a backup.
- Visit each language's home page.
- Click through the menu in each language.
- Check that forms and checkout show the right language.
- Confirm your XML sitemap includes the translated pages.
- Clear page and CDN caches after big changes.
WPML's guide on what to do after the setup wizard covers further steps such as translating media and taxonomies.
Frequently asked questions
Is WPML free?
No. WPML is a paid plugin sold on its own website with yearly plans. Some add-ons, such as WooCommerce Multilingual, are listed for free on WordPress.org but need the paid core plugin to work. Free alternatives include Polylang and some translation services with free tiers.
Does WPML translate content automatically?
It can. WPML offers automatic machine translation that uses credits, and you can review the results before or after publishing. You can also translate manually in its editor or send content to professional translators through translation management.
Is WPML good for SEO?
WPML creates separate URLs for each language and adds hreflang tags, which helps search engines show the right version to each visitor. It also works with popular SEO plugins so you can translate titles and meta descriptions.
Can I remove WPML later without losing content?
Your original language content stays in place if you remove WPML. Translated pages remain in the database as separate posts, but without WPML they lose their language links. Back up the site and plan the move carefully before removing it.
Does WPML slow down WordPress?
WPML adds database queries, so very large sites may notice some extra load. Good hosting, page caching and an object cache usually keep the impact small. Remove unused WPML add-ons to keep things lean.
Sources
- Getting started with WPML WPML
- Set up WPML WPML
- What happens after the WPML setup wizard WPML
- WooCommerce Multilingual & Multicurrency WordPress.org
- Localized versions of your pages Google Search Central
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.


