Translating with the Contentstack Connector
The Contentstack Connector supports translation of entries and release item content. Translations are requested from within the Smartling platform, and translated content is automatically sent to your Contentstack instance.
This article will walk you through the following:
- How to Request Translation
- Authorize the Job
- Jobs Awaiting Authorization
- How to bulk-select
- How to track translation progress
- How to manually export translations back to Contentstack
- How to handle updates to previously translated source content
Once you have connected your Contentstack account, you will find Contentstack content in the Contentstack tab in your Smartling project (New Experience), or from within Translate Content, under Contentstack in your Smartling Contentstack Project (Classic).
From here, use the Content Type filter to choose which content to translate.
There are two ways in which you can Request Translation;
1) Select the asset > Actions > Request Translation. This option also allows you to bulk-select multiple assets for translation.
2) Click the information icon of an asset > Request Translation. This option allows you to request translation for only that individual asset.
Both options will open the Request Translation wizard.
The Request Translation two-step wizard will appear for you to enter the Job details. You can choose to create a New Job or add the asset to an Existing Job.
- Insert the Job Name - the title for the translation task in Smartling
- Ensure the asset selection is correct. Click the X to remove any asset listed
- Insert a description for the linguists, if desired
- Select the Target Languages
- Click Save Job and Continue to create the Job in Smartling
Authorize the Job
The next step will display the Job Processing. Once the processing is complete, the Job has been created and the Authorize Job button will activate by turning blue. Click Authorize Job to set a Job Due Date, choose the workflow and submit the asset(s) for translation.
Jobs Awaiting Authorization
If your team submit content from Contentstack via the Smartling App, Account Owner or Project Manager users can find this content in a Job, awaiting authorization on the Jobs Dashboard. Simply click Authorize to begin the translation process for that content.
If you want to translate 50 assets or more in any given content type at once, you can perform a bulk selection to commence a mass translation process. To perform an action on the entire result set:
- Select the top checkbox that is in the table's header row.
- Choose the Select all matching current filter option that appears after you have selected all on the page.
- Choose to Request Translation or Export Translation of all assets listed
Recent Job Processes (bulk-selection)
When using the bulk actions feature to Request Translation, you can choose to create a new job or added the selected assets to an existing job (as seen in the new Request Translation wizard above).
Once you click Next, you will get confirmation that your job request is being processed. You can close the window, it won't disrupt the processing.
The number of bulk Job requests processed will be seen on the top right of the page. You can check the status of the Job Request by clicking the number icon.
This will open the Recent Job Processes dialog where you can view the details and status of each bulk Job Request taken. You can cancel any incomplete Job Requests by clicking the ellipses/3 dots under Actions > Stop Process
Track Translation Progress of each Asset per Language
You can track the translation progress of each asset per language on the Contentstack Progress page.
- Go to your Contentstack project in Smartling.
- Click the Gear icon > Contentstack Progress
If your Contentstack Connector is configured to manually check for changes to source content, an Outdated column will be present in the list. Each time source content has been updated in Contentstack, a tick will be seen under the Outdated column, beside the asset. Filter for outdated content by selecting the Outdated checkbox.
Export Translations to Contentstack
As translations are completed, they are automatically sent to your Contentstack instance as per your Contentstack Connector configuration (every three hours is the default and recommended frequency).
To perform a manual export of translated content from Smartling to Contentstack:
- From your Contentstack project, click the Contentstack tab (New Experience)
- Click on Contentstack > Translation Progress (Classic)
- Select the translated assets to download (Bulk-Select and Export is supported)
- Click Actions and select Export Translation (New Experience)
- Click Export to Contentstack (Classic)
Handling Updates to Contentstack Content
How your Contentstack Connector handles changes made to your source content in Contentstack is configured under changed content behavior within your Contentstack project settings
Talk to your Customer Success Manager or Solutions Architect about configuration options regarding how your Contentstack Connector retrieves translated content from Smartling.