WordPress Connector

WordPress Connector Request Translations

This article is for Account Owners and Project Managers and assumes that you have WordPress admin access.

The Smartling WordPress connector allows you to translate WordPress content in Smartling. Translations are requested from within WordPress, and translated content is sent back to your environment.

The connector supports translation of Posts, Pages, Categories, Tags, Theme Widgets, and Navigation Menus. Once you've installed and configured the WordPress Connector, you can begin submitting content for translation to Smartling.

Request Translations

When requesting translations via the Smarting WordPress connector, you will be prompted to add your content to a new or existing job.

Posts and Pages

Before adding your Post/Page to a new or existing job, make sure that you have already entered content in the body of the Post/Page and saved your draft. Otherwise, you may get an error.

When adding a new Post/Page to an existing job that already has content, the job can be renamed in the Name field, and will contain the new Post/Page and any pre-existing ones.

By default, Authorize Job is enabled. This automatically sets up your saved draft to begin the translation process in Smartling. (Uncheck Authorize Job if you are not yet ready to begin the translation process. However, once you are ready to authorize the job, you will need to log in to Smartling > Content > Jobs to do that.) 

All Other Types of Content

Once you have created any of the following items listed below, submit the content for translation via the Smartling > Bulk Submit menu.

  • Categories
  • Tags
  • Navigation Menus
  • Theme Widgets
  • Media

Use the Type filter to display the content you wish to add to a new or existing job. See Posts and Pages regarding renaming an existing job, as well as authorizing the job. The same procedures apply.

When using Bulk Submit, there may be a slight delay before content appears in Smartling.

Include Visual Context with your Translation Request

Visual context helps linguists get your translations right the first time - reducing translation cost and time to market. Use our Chrome Context plugin to capture and associate visual context with your translation requests after they've been submitted to Smartling.

Want to automate visual context capture? See our Context Tool Developer Guides.

Check Status of Translations

To check the progress of submitted content, within WordPress, go to the Smartling > Translation Progress menu and filter for the content you wish to see.

Translation progress is displayed as a percent in the Progress column. The overall status of the translation request is listed in the Status column.

If your translation request shows a failed status, you can resubmit the request from the Translation Progress page. Use the Bulk Actions menu to resend translation requests if multiple submissions fail.

Download Translations


The Smartling Connector can be configured to download translated content once it is complete on a schedule defined in your Wordpress configuration.


You can download translations manually from the Smartling Widget for any Post, Page, Category, Tag, Theme Widget, or Navigation Menu by clicking the Download button.

You can download translations manually in bulk from the Smartling Connector Translation Progress tab:

  1. From within Wordpress, click on Smartling > Translation Progress from the admin menu on the left hand side of the screen.
  2. Use the filter at the top of the screen to find your translation requests.
  3. Select individual pieces of content for translation using the checkbox next to each item, or click the checkbox at the top of the content table to select all items at once.
  4. From the Bulk Actions menu, select Enqueue for Download.
  5. Click Apply.

Bulk actions are executed by a scheduled task to prevent slowing down your WordPress instance.

Publishing Translated Posts

The Smartling Connector can be configured to automatically publish translated content once it is returned to your Wordpress instance.

If this setting is disabled, you will need to manually publish your post, page, category, tag, theme widget, or navigation menu using the Publish widget once translations are complete to make the content available to your end users.

If you submitted an item for translation, but excluded it from translation within Smartling, it may appear in English on localized sites. This is because when a post is completely excluded, 0 of 0 strings are translated, and therefore 100% translation complete. If the "Publish completed translation" option in Expert settings is enabled, then the translations will be published on target sites. You should therefore, not exclude the content.

Handling Updates to WordPress Content


The Smartling connector can be configured to automatically resubmit content to Smartling for translation whenever a change is detected in your source content.


If your resubmit mode is set to manual, you will need to resubmit Wordpress content as described above. Only the new Wordpress content from a post, page, category, tag, theme widget, or navigation menu will be authorized for translation in Smartling.

Lock a Translated Post

If you want to prevent a translated post from being affected by changes to the original post, you can lock the translation:

  1. Switch to the dashboard for your translated site by clicking on My Sites > Network Admin > Sites > [Your Translated Site].
  2. Navigate to your desired content, and check the Translation Locked checkbox in the Publish Widget.
  3. Click Update.

You can lock content in bulk using the Bulk Action menu in Smartling > Translation Progress.

Seeing unexpected connector behavior? Check your Wordpress connector configuration settings or download your connector logs and contact support@smartling.com.


Was this article helpful?