Locale: Adding the DatoCMS Connector to Locale

Owned by Bartosz Lewandowski
Last updated: Sept 18, 2024 by Damian Rozmiarkowski
3 min read

Introduction

The DatoCMS connector from Locale allows you to easily translate any text content types in your content models quickly and easily. Simply add the necessary target languages to your settings page and let Locale do the rest. And by connecting it with your existing workflows, you do not need to make changes to your translation provider, whether it is a single person, a translation agency (LSP) or even an MT server.

What you will need to get started

  1. The Login link for Locale.

  2. The Full-access API token from your DatoCMS instance.

    1. Note: This is located in your DatoCMS instance and can be found by following the steps here: Locale: Adding the DatoCMS Connector to Locale and in the instructions below. Locale does not have access to this nor do we provide this information. If you do not possess the correct credentials to access this information, please contact your system administrator or your DatoCMS representative.

  3. User login information for both your Locale instance, and your DatoCMS instance.

    1. A trial account of Locale can also be taken for free by going to locale.to and selecting the “Get Started” button.

Adding the DatoCMS Connector to Locale

  1. Start by accessing Locale with your username and password; instructions can be found here: Locale: Accessing your Locale instance.

  2. Once logged into Locale, you will see a Dashboard which looks something like this image below.

General Login 001.png

  1. Select the “Add Project” button and you’ll be presented with the Locale Connector Store.

  2. Select the “CMS” option in the menu filter to the left, and select the “Create Project” button under DatoCMS in the first row.

Configuring 002.png

  1. The next step will require you to enter the Full-access API token to proceed. The steps for acquiring this information can be found below.

    1. Note: If you already have this information, simply paste it into the space and click Locale: Creating a Locale project with the DatoCMS Connector for the next steps.

Accessing the Full-Access API Token in DatoCMS

  1. Start by accessing your DatoCMS instance with your username and password.

DatoCMS 001.png

  1. Navigate to the environment containing content you would like to send for translation, and enter the project to see a screen like the one below.

DatoCMS 002.png

  1. Select the Settings section at the top of the page and navigate to the permissions - API tokens section to the left.

DatoCMS 003.png

  1. Select the Full-access API token option, and copy the API key from the menu.

    1. Note: If this API token is regenerated at any time, this information will need to be updated in the Locale project as well to maintain localization functionality.

DatoCMS 004.png