Home » Documentation


Search the documentation:


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.

Continue reading

Getting Started Guide »

WPML consists of several modules. The basic module turns WordPress sites multilingual. Other modules help with an enhanced translation process, string translation, media translation and other functions.

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.

Continue reading

Essential Multilingual Plugins »

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-logoTypes 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.

Content Display

Views-logoViews 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.

Front-End Content Submission and Editing

CRED-logoCRED makes it easy to build forms that create and edit WordPress content. All CRED forms are connected to content types. When you build a form with CRED, you select what it will create or edit. Since CRED knows which fields and taxonomy every content type uses, it will automatically include the inputs for all of them. This means that you can build CRED forms without having to configure or define anything.

CRED is fully integrated with WPML. Any form label will be automatically registered for translation, making it easy to build multilingual-ready forms.

Access Control and Roles Management

Access-logoAccess is a simple, but powerful, role management and access control plugin. An intuitive interface will let you control what different user kinds, or specific users, can do on your site. You can also create your custom roles and group users in them. If you’re building any site that requires access control, Access will make it easy to implement.

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.


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
JigoShop JigoShop Multilingual Has known issues.
MarketPress MarketPress Multilingual Has known issues.
WP E-Commerce WPEC Multilingual Has known issues.


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.Continue reading

Translating Your Contents »

Your translation options

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.
Professional translation by a translation service
Select your translation vendor and streamline the translation process.

Additional translation tools

Using desktop CAT tools
Let your translators use their own CAT tools using WPML’s XLIFF interface.
Using CRED with front-end translation forms
Build your own translation forms and make it easier for your translators to work from your site’s frontend pages.

Continue reading

Professional Translation »

WPML’s translation management connects you with translation services offering professional translation. Watch the video below for a quick overview.

WPML’s professional translation overview (3:26)

How it Works

You’ll be controlling your entire site’s translation right from within the WordPress admin dashboard. This includes communicating with translators (available only with ICanLocalize), sending content to translation, tracking progress and receiving completed translations.

WordPress translation doesn’t get any easier than this. Use the links below to learn how to set-up professional translation for the available services.

Continue reading

Other WordPress plugins »

WPML didn’t quite start as WPML. It started as a few separate plugins, which later merged and became one.

Continue reading

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.

WPML affiliate page

On that page, you will see:

  1. Your affiliate text link
  2. A collection of affiliate banners
  3. A place to enter your PayPal email, so that we can pay you
  4. 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:


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