Table of Contents
Introduction
Empower your team with effortless localization management with the help of the ButterCMS connector. With just a few clicks, you’ll be on your way to automating your localization workflows for all your page and collection content and descriptions, and still keep the existing localization workflows you and your team are used to. Simplify your localization process and experience the difference with the ButterCMS connector from Locale.
What you’ll need to get started
The Login link for Locale (https://app.locale.to/en/)
An enterprise version of ButterCMS, or at least the activated Write API Token option.
Note: This is located in your ButterCMS instance, 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 ButterCMS representative.
User login information for both your Locale instance, and your ButterCMS instance
A trial account of Locale can also be taken for free by going to locale.to and selecting the “Get Started” button
Adding the ButterCMS Connector to Locale
Start by accessing Locale with your username and password.
Once logged into Locale (instructions on that can be found here) you’ll see a Dashboard which looks something like this image below.
Select the Add Project button and you’ll be presented with the Locale Connector Store.
Select the CMS option in the menu filter to the left, and select the Create Project button under ButterCMS in the first row.
The next step will require you to enter Access API token and Collections information to proceed.
To find the Access API Token information, start by accessing the Settings menu, and the General tab. In the API Tokens menu, copy the Write API Token and paste this into Locale.
If your menu looks like the screenshot instead of showing an API token, you’ll need to speak with your ButterCMS representative and ensure you have an Enterprise version
For the Collections information, simply make note of the Collections you’d like to translate from the Collections menu on the left
And enter these into Locale, separated with a comma but without spaces between each individual collection name.
Once you’ve added these components, select Next to create a Locale project with the ButterCMS Connector.
Creating a Locale project with the ButterCMS Connector
Once you’ve followed the steps above to configure the ButterCMS connector, you’re ready to create a project.
Start by entering the source and target languages for your instance and selecting Add Project.
Locale will automatically calculate the number of words which need to be translated for your project.
And provide the option to push them for translation.
Once the translation step has been completed, the status will update in Locale, and the content will be delivered into your ButterCMS instance.
