Introduction

The TranslationOS plugin for Contentstack allows you to outsource the professional translation of your entries to Translated, with no need to manually import and export content or switch between tools.

This connector is event-based, meaning it is triggered by specific actions. To learn which actions trigger the connector, see the section Requesting translations.

Support

For general questions about functionality, our dedicated support team can be reached at [email protected].

If you need technical information or you’re ready to integrate your Contentstack instance with TranslationOS, feel free to reach out to us at [email protected] for assistance with onboarding.

The onboarding process may vary depending on your needs, but the following steps are a helpful guideline:

  1. Translated will ask you to provide a stack API key and a management token (see below for instructions to retrieve them).
  2. Translated will enable you to test the connector in sandbox mode, which means that you will get back machine-translated content to test the user experience.
  3. You will agree with Translated on the required service levels, also known as service types. Translated will take care of configuring the connector for you.
  4. We will be ready to receive, process and deliver your translation requests!

Setting up the connector

You will need to retrieve the following three pieces of data from Contentstack and communicate them to Translated. We will then complete the connector configuration for you. With that done, you’ll be ready to set up the workflow that you’ll use to send your entries for translation.

To begin, log in to Contentstack with an admin account.

Generating a management token and retrieving the stack API key

To generate a management token and retrieve the stack API key, navigate to Settings > Tokens, select Management Tokens, then click + Management Token.

Screenshot 2024-02-05 at 10.25.07.png

Give the token a name and (optionally) a description, grant both read and write permissions, select Never under Expiry, then click Generate Token.