The Smartling App for Contentstack allows you and your team to seamlessly submit entry content for translation. This allows your content writers to continue to create spectacular new content in Contentstack, and instantly submit it to Smartling for translation, without ever leaving Contentstack.
Content submitted for translation via the widget will sit in Awaiting Authorization in Smartling until an Account Owner or Project Manager user Authorizes it for translation.
The Smartling Widget also allows you to track each language's translation progress from within Contentstack. Completed translations can be easily viewed and published from the Contentstack languages switcher.
Prerequisites
- You must have a connected Contentstack Connector project in Smartling
- Ensure the Contentstack Connector is connected to the correct stack in Contentstack.
- The Contentstack Connector project requires authentication to a specific stack in Contentstack. This is the stack that the Smartling App is integrated with. You can find the Smartling App in the widget page of that stack.
- A Contentstack Admin user must install the Smartling widget in Contentstack
- An Account Manager or Project Manager Smartling user must connect the Smartling App to the correct Smartling project
Installation
The following steps must be completed by a Contentstack Admin user:
- The Smartling App can be found in the Contentstack Marketplace. Search Smartling in the Apps and click install.
- Next, you need to choose the same stack that is already integrated with Smartling to install the widget, and accept the T&C's before clicking Install.
Once installed, you must click Save (on the bottom-right side of the page).
A green notifier will appear once this has been successfully installed.
Next, let's find the Smartling App in your widgets, and connect the Smartling App to your Contentstack Connector project in Smartling.
Connect the Smartling App to Smartling
The following steps must be completed by a Smartling Account Owner or Project Manager user:
- Go to the stack you selected to install the Smartling App to
- On the left navigation, click Entries
- Click on any entry you want to translate
- On the right navigation, click Widgets
- From your installed app list, select the Smartling App
- If it's your first time using the Smartling App, you will need to connect to your Contentstack Connector project in Smartling, by clicking configuration page
- This will open a new tab in your browser where you can log into Smartling using your Smartling credentials. Once logged in, you will see the following page:
- Simply close this tab and return to Contentstack, where you must choose which Smartling project to submit content to. Ensure this project is a live Contentstack Connector project, with correct language mapping
- Once you have selected a project from the dropdown, click Save
Now you're ready to translate entries from Contentstack!
Submit Content for Translation
The following steps can be completed by any Contentstack user who has access to the specific stack:
- Go to the stack you selected to install the Smartling App to
- On the left navigation, click Entries
- Click on any entry you want to translate
- On the right navigation, click Widgets
- From your installed app list, select the Smartling App
- Click Request Translation to create a Job in Smartling
- 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.
- Choose to include Related Assets. For more information, see the links guide.
- Insert a description for the linguists, if desired.
- Select the Target Languages.
- Click Save Job and Continue to create the Job in Smartling.
The next step will display the Job Processing.
- Once the processing is complete, the Job details will appear. This means that the content has been successfully submitted to Smartling. Simply click Back to view the progress of each language in the Job
Authorize the Job
The following steps must be completed by a Smartling Account Owner or Project Manager user:
Once your content has been submitted to Smartling, an Account Owner or Project Manager user can find the Job in Awaiting Authorization on the Jobs Dashboard. Once Authorized, you can monitor the translation progress for each language in the Job, directly from the Smartling App in Contentstack.
Monitor Translation Progress from Contentstack
The following steps can be completed by any Contentstack user who has access to the specific stack:
- If you want to add another language to the Job for that entry, simply click Request Translation and add the content to the existing Job.
- Once translations are complete, the Smartling Status will indicate a green COMPLETED.
View & Publish Translations in Contentstack
The following steps can be completed by any Contentstack user who has access to the specific stack:
- To view the translated entry, click the language dropdown and select a language
- Choose to Publish this translated entry in Contentstack when it's ready
Unpublish Translations in Contentstack
The following steps can be completed by any Contentstack user who has access to the specific stack:
Unlocalizing the entry will prevent the translations being applied to the entry, and revert the copy to the source language. To undo this action, simply click Save and the entry will localize in the target language. unpublish trans