WordPress: WPML integration

WPML (The WordPress Multilingual Plugin) is designed to build multilingual sites and run them. It is the most popular and reliable plugin of its kind on the market with over 1,255,000 users to date. Using the integration between WPML and Smartcat, you can pull source content from WPML to Smartcat, translate it, and then push the translation into the corresponding source type.

1. Prerequisites

Before you start configuring the integration, make sure that you have WPML Multilingual CMS add-on installed on your machine, and then proceed as follows:

  1. Configure the WPML plugin. Navigate to WPML > Settings.
  2. Go to the Post Types Translation section and pick the content you want to translate by selecting the radio buttons. Content is separated by type.
  3. Navigate to WPML > Languages and choose the required languages by clicking Add / Remove languages.
  4. To enable Smartcat integration on your WPML-enabled WordPress site, you need to install Smartcat plugin from https://wordpress.org/plugins/smartcat-wpml/
  5. Navigate to Settings > Smartcat Integration for WPML and click the key icon to generate an API Key. Copy the API Key and save it for further use.
  6. Copy the URL of your WordPress site and save it for later use.

2. Configuring the integration

To configure the WPML integration, log in to Smartcat and complete the following steps:

  1. Create a new integration project as described here.
  2. In the Integrations tab, click Connect in the Wordpress/WPML integration tile.
  3. Paste the saved API Key to the Smartcat Integration for WPML API Key field.
  4. Paste the URL of your WordPress site to the WordPress site base URL field.
  5. Click Create Integration.

3. Using the integration

If the integration is created successfully, the content of the site whose URL you indicated in the settings is synchronized with the current Smartcat project and all the documents stored in the folder appear as Smartcat project documents.

After a document translation is completed, return to the integration settings, open the Settings tab, enable the option Push translations back and click Sync Now. The translated documents will be pushed to WPML and will appear as an additional language in the respective content type. The addition of a new language is indicated by the pencil icon in the Languages column.


If new source segments were added to the integrated space since the previous sync, the Smartcat documents will be updated accordingly.

By default, a sync disregards incomplete translations. You can, however, instruct the integration to include them in every sync by enabling the option Publish incomplete documents.

Instead of explicitly performing sync by clicking Sync Now, you can schedule a sync at the required intervals. To do this, click on Do not repeat and select the appropriate option from the drop-down menu. 

Need some extra help with you WordPress website? Smartcat recommends Codeable for our preferred WordPress development resource.

Was this article helpful?

Do you need a human-assisted guidance? 🙌

Request a demo