Contentstack does not offer translation services but we provide the ability to integrate with third-party translation providers and translate content. Using Contentstack workflows, set up a webhook to trigger when your workflow stage changes to “Send to Translation.” Once the webhook triggers, initiate the translation process. You can use any popular translation tool, such as Worldserver and iLangl, to translate content.
Additional Resource: Interested in learning how to set up your own translation system, you can try out our Set up a Translation System with Contentstack Webhooks and Workflows, AWS Lambda, and AWS Translate and Setting up Translation System with Contentstack Webhooks, Memsource, and AWS Lambda guides.
Below is a detailed guide on how some of our customers have achieved this. Please note, each customer’s process may vary and this guide is meant to be a point of reference to help you get started.
Let’s have a look at the steps involved throughout the process of translating content.
- Set up the essentials
- Set up workflows for translation
- Trigger a webhook to initiate translation
- Translate content using a translation provider
- Use Content Management APIs to update translated content
Set up the essentials
Once you have your initial stack configured, then you’re ready to begin the integration process for translation.
Set up workflows for translation
To set up workflows for the translation process within Contentstack, follow the below steps:
- Create a workflow by navigating to the “settings” gear icon and clicking on Workflows
- Click on Add Workflow.
- Create your workflow stages and transition rules to fit your content editorial team’s process.
Sample translation process
Below is an advanced workflow example for translation. Please note, this can be simplified or modified to fit your team's process.
- Copy and assets are approved and do not change after translation is requested.
- Copy and assets change during translation.
- Found an error on the live site and translation needs to be amended.
- Found an error on live site and English and translation need to be amended.
- Found an error on live site and only English needs to be amended.
The diagrams below show the different workflow stages set up for a sample translation process:
Trigger a webhook to initiate translation
Contentstack outputs JSON content via its powerful APIs. A simple way to get content out of Contentstack into a translation tool such as iLangl and Worldserver is to utilize our webhooks. You can think of webhooks as a trigger event for anything that happens in Contentstack. Webhooks also send the entire JSON payload when called for easy integration.
Additional Resource: Here's a complete list of all webhook events for your reference.
Let’s have a look at the steps involved in creating a webhook to send content for translation.
- Create a webhook by navigating to the “settings” gear icon and clicking on Webhooks
- Click on + New Webhook.
- Under the When section, select the options Any | Entry | All | Workflow Stage Changed | (Workflow name) | (Stage name e.g., “Send to Translation”).
This will configure your webhook to trigger on a workflow stage change such as “Send to Translation”, like in the above workflow example.
Translate content using a translation provider
The translation provider can now retrieve your JSON output upon receiving the webhook call on a secure translation server. Most providers will map the JSON output to strings using our UID fields as keys, then provide the translated output and send it back to Contentstack via the Content Management API. Most providers also provide what’s called “Translation Memory” and store already translated values for quicker turnaround times for localization.
To translate content, work with your translation provider to configure the mapping of JSON strings and keys for translation.
Check out this video from one of our partners, iLangL.
Use Content Management APIs to update translated content
Contentstack offers powerful Content Management API requests which allow you to perform almost everything you can do in our web UI, such as updating entries and changing workflow stages.
Let’s have a look at the steps involved in updating translated content with the use of these APIs:
- Work with your translation provider to configure the update entry API, which will use the language parameter to pass the translated strings back into the entry.
- After the strings are passed into the entry, update the workflow stage to “Review Translation” or similar via our Content Management API.
This would take place if your translation provider were to supply this type of output and your market specific experts go in and review the machine translation.
The following translation integration diagram lists the steps and decisions needed to perform the translation process with Contentstack: