Contentful Connector

Request Translations Using the Contentful Connector

This article is for Account Owners.

Once the Contentful Connector has been set up, you will be able to manage the translation process. From the Contentful Content tab, you will be able to request (and authorize) translations and track progress. The following steps are done within Smartling.

Request Translations (New Experience)

To request content for translation: 

  1. In your Contentful project, click the Contentful tab. 
  2. Under Contentful Space, select your project space. 
  3. Select the assets that you want to translate.
  4. Click Actions and select Request Translation
  5. Enter a Job name and select the Languages to translate to. 
  6. Select either Just the selected items or Also request translation of all related items. For more information, see the links guide.
  7. Click Create Job

Request Translations (Classic)

Follow these steps to request (and authorize) translations into a workflow for translation.

  1. Go to Projects (select your Contentful project) > Contentful.
  2. Click Login to Contentful. See this article if you need more information about logging in.
  3. Select your project space from the drop down menu. 
  4. The content that needs to be translated is also referred to as "assets". Select the assets and click Request Translation
  5. Choose your target languages and select either: Translate just selected entries or Also translate other, related entries. Read the links guide to learn more about linked entries.
  6. Click Request Translation. Requesting translations automatically authorizes your content.

View Asset Details (New Experience)

From the Contentful tab, click any asset name to view its details. If the asset has linked entries, you'll be able to view them under Linked Entries

View Asset Details (Classic)

Within Contentful Content, click on any asset to view its details. From the details page of the asset, you'll be able to view the linked entries for that asset.


Track Overall Progress 

To track the overall progress of your translations using the Contentful Connector:

  1. Do one of the following: 
    • In the New Experience, from your project, click the Contentful tab.  
    • In the Classic Experience, go to Contentful > Contentful Content.
  2. Click an asset to see the percentage of work completed for each language.

Track Progress by String (New Experience)

  1. In your project, click the Strings tab.
  2. On the left side, under Status, select In Progress

Track Progress by String (Classic)

To track the progress of your translations using the Contentful Connector, by string:

  1. Go to Content > Translations.
  2. Near the top of the page, make sure that the In Progress view is selected for the desired language.

If you need to add languages to your Contentful Connector project, go to Projects > Content > Summary and click +Add Languages within the Languages section.

Filter Content 

Within the Contentful Connector, you can filter content by:

  • Contentful Project
  • Contentful Model Type
  • Contentful Connector Status
    • New: The asset import was requested, but not yet imported. Assets only stay in this state for seconds, however, this can be slightly longer if you have submitted thousands of assets.
    • In Progress: This refers to the content for which you requested translation.
    • Failed: This status will appear if the connector failed with a recoverable error that requires the user intervention. You can mouseover "Failed" to reveal a tooltip about the error.
      • Example of a Failed status: Translations in Smartling were completed, but the content in Contentful was deleted, and therefore, the translated content was not able to pushed back to Contentful.
    • Completed: This refers to content that has been translated.
  • Locale
  • Using the search field


Was this article helpful?