Documentation
FAQ »
See answers to frequently asked questions.Continue reading
WPML Core and Add-on Plugins »
WPML is made of a core plugin and add-ons. The core WPML Multilingual CMS is always required. You can install any combination of the add-on plugins for additional functionality.
Theme Compatibility »
Jump directly to...
Many themes work fine on multilingual sites. To make sure, we work with theme authors and perform extensive testing. Then, we list those theme here.
Multilingual Ready Certification
Look for the Multilingual Ready icon on themes before you purchase them.
This icon means that we tested the theme and certified it. If you’re not sure, contact the author and refer them to our certification program.
Multilingual Ready Themes
| Theme house | Theme | Compatibility |
|---|---|---|
| WooThemes | Works with WPML, including a language configuration file which allows translating texts in the theme Admin screens. | |
| Ultimatum Theme | Tested by WPML team. | |
| ThemesZen | Tested by the theme author. | |
| ThemeForest | Tested by the theme author and reviewed by WPML team. | |
| ThemeForest | Tested by the theme author and reviewed by WPML team. | |
| ThemeForest | Tested by the theme author and reviewed by WPML team. | |
| ThemeForest | Tested by the theme author and reviewed by WPML team. | |
| ThemeForest | Tested by the theme author. | |
| ThemeForest | Tested by the theme author. | |
| ThemeForest | Tested by the theme author. | |
| ThemeForest | Tested by the theme author and reviewed by WPML team. | |
| StudioPress | Tested by WPML team. | |
| Roots | Tested by the theme author and reviewed by WPML team. | |
| Khairul Syahir | Tested by the theme author. | |
| Headway Themes | Headway 2.0.9 tested by WPML team. Headway 3 leafs are not properly translatable. | |
| Crowd Favorite | Tested by WPML team. | |
| Catalyst | Tested by the theme author. | |
| BytesforAll | Tested by WPML team. | |
| AIT Themes | Tested by the theme author. | |
| AIT Themes | Tested by the theme author. | |
| AIT Themes | Tested by the theme author. | |
| AIT Themes | Tested by the theme author. |
Essential Multilingual Plugins »
Jump directly to...
We work with other authors to ensure compatibility with WordPress plugins. These are major plugins that are multilingual-ready.
Custom Post Types and Custom Fields
Types is a one-stop solution for creating custom post types, custom taxonomy and fields. Besides defining custom data, you can also create elaborate meta-boxes and assign them to any post-editing screen. Types is the only custom-types plugin which is fully integrated with WPML. You’ll be able to translate everything related with your custom content, including field labels and content names.
When you translate content, non-textual fields will automatically synchronize between translations and text fields will appear in the translation editor.
Site-Building
Views works together with Types, to deliver a programming-free website creation experience. Web developers and designers, of all expertise levels, will benefit from this solution. Views queries content from the database, supporting detailed filtering. It displays it via user-editable HTML templates. With just HTML and CSS, users can create the most complex sites with Views.
Views is fully integrated with WPML. Any text that is rendered can also be translated.
Search Engine Optimization
WordPress SEO by Yoast is an all-around solution for optimizing WordPress sites for search engines. The plugin lets you specify titles and description for any WordPress content and archive page and shows how each page will appear in Google search results.
It includes a language configuration file that tells WPML which strings require translation. This way, you can translate everything, without having to configure anything.
E-Commerce
There are a number of great E-Commerce plugins that you can use with WPML:
| Plugin | WPML Support | Notes |
|---|---|---|
| WooCommerce | WooCommerce Multilingual | Fully multilingual with WPML and actively maintained |
| MarketPress | MarketPress Multilingual | Fully multilingual with WPML and actively maintained |
| WP E-Commerce | WPEC Multilingual | Most features work correctly with WPML. There is a know problem with product variations. |
Search
While the built-in WordPress search leaves much to be desired, Relevanssi fills the gap beautifully. It lets users search and find what they’re looking for. You can download Relevanssi for free from the WordPress repository or purchase the pro-version from Relevanssi.com.
Both versions of Relevanssi run smooth with WPML and return search results in the current language.
Admin Page Order
If your site has hundreds, or thousands of pages, it may be a bit difficult to find them in the WordPress Admin. CMS Tree Page View presents your pages in a hierarchical tree, which you can expand and collapse. It works smooth with WPML and displays the correct tree per language.
Want to see other plugins here?
Send us a message and we’ll see if we can add it.Continue reading
Getting Started Guide »
Jump directly to...
WPML consists of several module. The basic module turns WordPress sites multilingual. Other modules help with an enhanced translation process, string translation, media translation and other function.
You can learn about the different modules in the WPML Core and Addons page.
After you enable WPML, you’ll see a Multilingual Widget in the Admin Dashboard. This widget provides access to the different functions in WPML. You can also access them through the WPML menu.
Translating Your Contents »
Jump directly to...
The best way to learn about how to run a multilingual WordPress site with WPML is to review the complete WPML guide for site owners and translators.
Free WPML manual (PDF 13Mbyte)
You can also find this information, broken into different sections on this page.
WPML includes three options for translating:
- Manually creating posts and pages in other languages
- Create translations as new posts or pages using the standard WordPress editor.
- Using the Translation Management module
- Control who’s translating what and give your translators better tools. See demo

- Professional translation by ICanLocalize
- You can find freelance translators from ICanLocalize between over 30 languages. See demo

- Using desktop CAT tools
- Let your translators use their own CAT tools using WPML’s XLIFF interface.
Professional Translation »
Jump directly to...
- Translation for Visitor Comments
- Setting up Professional Translation
- Our Translators
- Affiliate Program
- Translating Custom Fields
- Sending Documents to Translation
- Earning Affiliate Commission
- Translating the Theme
- Sending and Receiving Translations
- Translation Process
- Adding Affiliate ID to Themes
- Built in QA
- Cost
- Professional Translation Setup Assistance
- Coupon for Free Professional Translation
WPML’s professional translation connects you with expert translators working at competitive rates. We’ll help you reach new clients faster and on a tiny budget.
We handle anything from single-page to corporate sites. You will find translators to over 30 languages, ready to get started today.
Developers Information »
Jump directly to...
- Editing WPML’s Languages Table
- Language Configuration Files
- Multisite Support
- WPML Contractors
- Translating Custom Data Structures
- WPML Coding API
- XML-RPC language interface
- Custom multilingual themes
- WPML’s tables
- Debugging WPML
- Translation for texts by other plugins and themes
- Troubleshooting String Localization
WPML lets you run one WordPress site in multiple languages. The basic setup takes a few minutes and you can see the site multilingual. Then, you can customize the behavior and appearance of your site to match your exact specifications.
Related Projects »
Jump directly to...
Along with WPML, we also maintain several related projects, which allow other kinds of sites to run multilingual.
Other WordPress plugins »
Jump directly to...
WPML didn’t quite start as WPML. It started as a few separate plugins, which later merged and became one.
Affiliate Program »
Are you enjoying WPML? Tell the world about it and earn 30% affiliate commission for every new customer that you bring.
WPML’s affiliate program is open only to WPML clients. We truly believe that you can only recommend a product that you’re actually using.
Log in to your WPML account and click on the ‘Affiliate’ link.
On that page, you will see:
- Your affiliate text link
- A collection of affiliate banners
- A place to enter your PayPal email, so that we can pay you
- Your affiliate balance
How it works
Whenever you refer to people to WPML, through your affiliate link, we create a cookie in their browsers. The cookie doesn’t expire. It will only be set if this is the first visit to WPML.org.
Then, when this visitor becomes a client, we detect the cookie and associate the new account with yours, remembering that you brought this new client. Your affiliate account is immediately credited with every new purchase.
Using text links
You can link to us using a regular text link. Your affiliate link is displayed at the top of your affiliate page.
You can include such links to any page in WPML.org. Remember to add the aid and affiliate_key arguments to the URL. For example, my own affiliate link to our ‘Purchase’ page would be:
http://wpml.org/purchase/?aid=2&affiliate_key=hkZY0cb9tCUA
From past experience, we know that the most conversions happen when linking to both the homepage and purchase page.
Using banners
If you have available banner space, you’re welcome to use the WPML banners we’ve prepared for you.
There are banners in six sizes and in fifteen languages (more coming soon). Just above the banners you’ll find a language switcher (not the top-right of the screen, the one over the banners). This language switcher controls the language of the banners.
The banner graphics comes from our CDN (content distribution network). It’s a high-speed network with no bandwidth cap and terrific uptime. You’re welcome to use the images from there, or download them and serve from your own server.
Below each banner, you’ll find a link that include your affiliate info, the localized ALT and TITLE attributes and a link to the image. If you want to link to anything else than the home-page, feel free to edit the HREF attribute.
Getting paid
We pay via PayPal mass payments once per month, at the beginning of the month. Mass-payments means that you’re getting the full amount without seeing any PayPal fees (we pay them).
Be sure to enter your PayPal email, so that we can actually send your payment. If we don’t have that email, we’ll keep holding your due payment, until we can send it.
At the table in the bottom of the affiliate page, you’ll see your current balance, your total earnings (from day one) and when you last got paid.
All set?
We hope that this is enough to get started. If you need anything else, please contact us.Continue reading
