Smartling Connector


The Smartling Connector extends the WordPress interface for seamless management of the translation process, all while leveraging the tools contained in Smartling’s Global Fluency Platform. Easily installed with minimal developer support, the combination of WordPress and Smartling provides users with a powerful technology solution to manage the translation and localization process with full visibility and control across the entire organization.

Integration Features

  • Automatic change detection for content updates
  • Robust custom workflow engine configurable per language
  • Automatic download of completed translations to WordPress
  • Translation Memory integration
  • No tie-ins to translation agencies or vendors
  • Reporting for translation velocity, efficiency


  • Submit posts for translation using the Smartling Post Widget directly from the Edit page. View translation status for languages that have already been requested.
  • The Bulk Submit page allows submission of Post, Page, Category, Tag, Navigation Menu and Theme Widget text for all configured locales from a single interface.
  • Track translation status within WordPress from the Submissions Board. View overall progress of submitted translation requests as well as resend updated content.


Minimum Requirements

  • WordPress 4.6 or higher
  • Multisite mode enabled
  • PHP Version 7.2 or higher
  • PHP extensions:
    • mbstring
    • curl
    • libxml
    • xml
    • xmlreader
    • xmlwriter
    • yaml
    • gd
    • json
  • For “WP Engine” hosting maximum execution time should be set to 300 seconds.

The full step by step guide can be found here.

  1. Upload the unzipped Smartling Connector plugin to the /wp-content/plugins/ directory.
  2. Go to the Plugins screen and Network Activate the Smartling Connector plugin.
  3. Navigate to the Smartling – Settings page (/wp-admin/network/admin.php?page=smartling_configuration_profile_list) and click Add Profile.
  4. Set the Project ID, User Identifier and Token Secret credentials found in the Smartling Dashboard for the project created for WordPress.
  5. Select the Default Locale and the target locales for the translated sites you are creating.


Additional information on the Smartling Connector for WordPress can be found here.


There are no reviews for this plugin.

Contributors & Developers

“Smartling Connector” is open source software. The following people have contributed to this plugin.


Translate “Smartling Connector” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Minimum required PHP version is now 7.2! The next plugin release will require PHP 7.4.
  • Added ability to lock translation for some of the Gutenberg blocks in post content. The lock will preserve translated blocks, unless there are changes to the parents’ post structure of blocks, such as blocks reordering, or adding new blocks.


  • Added media attachments rules user interface in Fine Tune section. It allows to specify paths to media attachments inside Gutenberg blocks. The plugin will link the attachment ids for known paths between source and target sites


  • Fixed issue where translated image-text blocks appear to have “invalid content” warnings in editor


  • Fixed issue where quotes would break encoded JSON values in custom blocks


  • Fixed issue where deleting a blog would fail with a critical wordpress error


  • Fixed issue where menu items were not sent for translation when sending menus for translation


  • Fixed issue when notices were not displayed on successful translation download
  • Fixed compatibility with newer Multilingual Press plugin versions


  • Auto synchronize properties on translated page with source feature doesn’t alter locked and excluded fields


  • Added new UI (Smartling -> Taxonomy links) where you can link existing translated taxonomies with the source taxonomies. It helps connector to respect existing translations and use them in translated posts.
  • Fixed issue where attachments were partially uploaded if post content contained multiple ACF blocks of the same type


  • Fixed issue where submitting related content type that was not registered in WordPress caused submission to fail


  • Fixed issue where submitting a widget that has navigation menus for translation caused a WordPress emergency


  • Major change in Auto synchronize properties behavior. Starting from this release the connector will always replace all metadata in the translated post with metadata from the source post. The translations are then applied to freshly copied metadata.
  • If you use ACF flexible fields then you should enable Auto synchronize properties. It will force connector always replicate ACF fields from source to target and keep flexible fields consistent
  • Fixed error messages not displaying when adding content to existing jobs


  • Fixed upload flow when post gets uploaded to Smartling without related content


  • Fixed download flow if ACF attachment field has an empty id inside Gutenberg block


  • Fixed upload issue if translation was requested from “Create job” form in WP 5.5.1+


  • The plugin will now mark submissions as failed when receiving certain errors from the API. Such submissions will be skipped while checking submissions statuses unless resubmitted manually


  • Fixed bulk submit page not submitting when post type slug contained dashes


  • Fixed daily bucket job uploads handling failure due to content being added to an unsuitable translation job


  • Fixed issue where submissions would not download if the upload sent only current content for translation


  • Improved support for ACF in Gutenberg blocks when translations are being downloaded in bulk


  • Added support for attachments inside ACF fields in Gutenberg blocks


  • Fixed issue where clicking the download button would not download translations
  • Skip all related content checkbox now has a default state expert setting
  • Further improved support for Gutenberg blocks (editor should no longer display “invalid content” warning)
  • Fixed issue with some items not being ingested when using ACF plugin


  • Display reason for failed submissions in status circle
  • Improved support for core Gutenberg blocks (fixed issue with “This block contains unexpected or invalid content” message when editing the block in translated content)


Added expert setting to support regular expressions for Exclude fields by field name and Copy fields by field name


  • Fixed issue when Smartling widget erroneously reported that translations were downloaded even if they weren’t
  • Fixed issue with daily bucket jobs being created when active profile is set to manual upload


Improved translation support of ACF Blocks for Gutenberg


Fixed issue where a content linking error causes a wordpress critical error message


  • Fixed time submitted display on translation progress page
  • Fixed ACF integration: images and other non-translated media should copy to translated content


Fixed issue with locale labels in locale selection wizard when Multilingual Press locale is unknown


Fixed issue with creating a new job from the Post Edit screen


  • Changed the default behavior for how we handle related content for the “request translations” flow (see v1.12.0 for more details):
    • When you request the translation from the Post Edit screen it submits only the current page and optionally you can tell it to submit only the immediate related content (tags, categories, images, etc)
    • When you request from the Bulk Submit screen, it will only submit the selected content (any related content should be requested manually)
  • Fixed compatibility with the ACF plugin and extended support for unicode characters (emoji, accented characters) in translation


This release brings major changes to how the connector works with related content. An example, a page may have a tag and a featured image. Before when you requested translation for a page, the connector submitted the page, plus the tag and image (3 file uploads in total). This approach guarantees that the translated page will look similar to the original page and the layout is not broken. The drawback of this approach, you can’t control how much content will be uploaded to Smartling. If your site has cross-references between pages then requesting a single page may trigger hundreds of uploads.
The new connector version adds the new toggle that controls this behavior. Now you can tell the connector to submit only requested content or requested content + immediate related content.

The new toggle can be found in Smartling -> Settings -> Show Expert Settings -> Handle relations, where:

  • Automatically – use the legacy approach, upload as much related content to Smartling as possible.
  • Manually – use the new approach, upload only the requested content or the requested content + the immediate related content.


  • Fixed issue with download button at post edit page.


  • Added required third-party libraries


  • Added extension to manage shortcodes and filters to be handled by smartling-connector.

Old entries moved to changelog.txt