WordPress (TMS)

Content is machine translated from English by Phrase Language AI.

Available for

  • Team, Business and Enterprise plans

Get in touch with Sales for licensing questions.

Available for

  • Ultimate and Enterprise plans (Legacy)

Get in touch with Sales for licensing questions.


For information about WordPress integration in Phrase Strings, refer to WordPress (Strings).

WordPress is an open-source blogging and web content management system. It also supports mailing lists, forums, media galleries, analytics, and online stores.

The connector supports WPML and Multilingual Press plugins. It automatically detects which plugin is installed during the Phrase Plugin installation. Which mode the plugin is running in can be viewed in Advanced settings.

The connector does not support 2FA. 2FA can be enabled for wp-admin or the frontend, but all endpoints starting with /wp-json/memsource/v1/connector must be accessible from Phrase without 2FA. The endpoints used by the connector are already secured with a Phrase token and security can be improved by adding a basic auth and/or only allowing access from Phrase IPs.

Supported Versions

  • WordPress Version: 4.9 or higher, including multi-site installations (Phrase plugin and WPML need to be installed to all sites)

  • PHP Version: 7.0 or higher

  • WPML Plugin: version 3.7 or higher

  • Multilingual Press Plugin: version 3.7.0 or higher

Supported Content Types

WordPress connector allows the downloading of source content and uploading of target localizations directly to/from WordPress for the following content types:

  • Posts

  • Pages

  • Tags

  • Categories

  • Custom post types

  • Custom taxonomies

Supported Statuses

  • Published and Draft (In-context preview supported for posts and derived content)


Some HTML tags present a risk and the CAT editor removes them from this HTML when displaying the preview. This is to ensure user's data privacy and security.

Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.

Supported Plugins

The following plugins are supported by the Phrase Translation Plugin for WordPress:

  • Avada

  • Divi

  • Elementor

  • Gutenberg

    • Predefined blocks are configured automatically. Configure Custom blocks in Gutenberg blocks under the Phrase menu. If not configured, content will not be imported.

  • Yoast SEO

  • SEOPress

  • WPBakery Page Builder (formerly Visual Composer)

  • Avia (Enfold Theme)

    • Enfold custom fields must be deselected because they are not supported. Click on the Phrase Plugin in your WordPress account and go to the Custom fields page to deselect the Enfold custom fields.

Use Cases

There are a number of use cases for the connector:

  • Project managers can add files directly to projects from an online repository.

  • With the Advanced Custom Fields (ACF) plugin, individual workflows can be defined within WordPress. Phrase monitors the changes to workflow steps and updates them accordingly, e.g. from Translate to Translation in Progress to Translation Completed.

  • Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.

  • Use automated project creation (APC) to have new projects automatically created when a change in the last modified date is detected for monitored files or a folder.

    • Selected files are imported the very first time APC runs. All files are imported when a folder is monitored.

Configure In-Context Preview

The In-context preview feature offers a real-time preview of original or translated text in both the CAT web editor and CAT desktop editor.

Phrase requirements:

  • Pass through the enterprise firewall to access the on-premise installation.

  • Authenticate into the authoring environment.

Firewall configuration for on-premise installation:

  • Installation must be accessible from the following IP addresses:,,,

  • Domain name must be able to be resolved externally.


Some HTML tags present a risk and the CAT editor removes them from this HTML when displaying the preview. This is to ensure user's data privacy and security.

Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.

WordPress Settings

  1. Install the WPML or Multilingual Press plugin to create and manage multilingual pages.

  2. Go to Phrase in the left-hand navigation panel.

  3. Click Connector and then Show Connector settings.

  4. Click Generate new token to generate a token to establish the connection.

  5. Select which posts should be imported based on their status and what status should be assigned to the translated content sent back.

  6. Navigate to the Custom fields page and select custom fields from the list that should be exported from WordPress and translated. All custom fields are selected for export by default.

  7. Navigate to the Language mapping page and map WordPress languages to Phrase language codes.

  8. Go to the Shortcodes page to see the list of supported shortcodes or add a custom shortcode that was created using a third-party shortcode plugin.

  9. Provide Translate to languages specified in (APC).

    Automated Project Creation only creates jobs for languages specified in the custom field identified by its Field Name – e.g. target_languages. The field type should be the multi-value picklist, where the values match the language codes.


Languages in WPML must match the languages of the project. To support local variations such as French (Canada), define the languages in the WPML panel inside WordPress.

Phrase TMS Settings

  1. From the Settings Setup_gear.png page, scroll down to the Integrations section.

  2. Click on Connectors.

    The Connectors page opens.

  3. Click New.

    The Create page opens.

  4. Enter the WordPress site URL.

    Example: If your WordPress admin page URL was, the site URL would be

  5. Enter the Phrase WordPress plugin token with the token from Phrase plugin configuration.

  6. If the site is secured using basic HTTP authentication, provide Username and Password as set in WP admin.

  7. Click Test connection.

    A list of configured languages will appear if the connection was successful. A red exclamation point will appear with an error message if it wasn't. Hover over the icon to see additional details.

    If the source or target is changed, clicking Test connection will refresh the selection of configured languages.

  8. Click Save.

    The connector is added to the list on the Connectors page.


What to do if imported text is full of code

Some WordPress add-ons inject code into your WordPress pages. Phrase does not handle this code without further configuration.

Add-ons known to cause this issue are:

  • Avia Layout Builder

  • Divi Builder

  • Fusion Builder

  • Visual Composer

  • WPBakery (formerly Visual Composer)

To configure Phrase in this case, indicate in WordPress which custom fields you wish to translate.

Go to Phrase Plugin, then Shortcodes, and add the shortcodes based on the specification of the addon format.

WPBakery settings:

Bakery Settings

Connection Test Fails when Configuring the Connector

Some WordPress plugins, like WP Hardening, WP Security, WP Staging, Disable WP REST API, or Wordfence Security, provide options for disabling the JSON API. Ensure the WordPress API is not disabled.

Was this article helpful?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.