WordPress: WPML integration

Please, note: This page describes a special version of the WordPress connector that synchronizes all content for a fully automatic translation and is available upon request. To send individual translation requests into Smartcat right from WordPress, use our WordPress App.

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 on “I need a secret key to set up integrations from Smartcat”. 
  6. On the next screen, click the Sync icon to generate an API Key. Copy the API Key and save it for further use.
  7. 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. If you want to use this integration option, please contact our Support team so that we can enable it for you.
  2. Paste the saved API Key to the Smartcat Integration for WPML API Key field.
  3. Paste the URL of your WordPress site to the WordPress site base URL field.
  4. Click Create Integration.
  5. Select Source and Target languages, and workflow. Please note that the lists of source and target languages are limited by the languages set up in WPML in your WordPress instance.
  6. Select content and custom fields you want to translate – you can either select all of them or specific ones. Additionally, you can select strings for translation.
  7. Click Create integration.

3. Using the integration

If the integration is created successfully, the content you indicated in the settings is synchronized with the current Smartcat project and appears 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. 

Please note that the content in WordPress can be created using various third-party plugins. Here is the list of plugins supported by Smartcat integration:

  1. Advanced Custom Fields (ACF)
  2. CMB2
  3. VC/WPBakery
  4. Elementor

If some of your content is not found by our integrations, please reach out to our support team so that we can investigate the way to support your case.

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


Did this article help you find the answer you were looking for? If not or if you have further questions, please contact our support team.

Was this article helpful?

Do you need a human-assisted guidance? 🙌

Request a demo