How to Set Up and Use the ButterCMS Integration

Integrating ButterCMS with Smartcat allows you to translate your website content efficiently while keeping it synchronized across both platforms. This guide will help you set up the integration, map languages, and start translating your CMS pages directly in Smartcat — even if it’s your first time using the platform.

In this guide, you’ll learn how to:

• Connect ButterCMS to your Smartcat workspace.

• Configure your API keys and localization settings.

• Map your ButterCMS locales to Smartcat languages.

• Create and verify your integration.

• Troubleshoot common issues.

1. Log in to your Smartcat Workspace.

2. From your homepage, click Set up an integration.

3. From the available options, select ButterCMS.

1. In a separate browser tab, open your ButterCMS account settings.

2. Locate your API Keys (both Read and Write keys).

3. Copy these keys and paste them into the Create Integration form in Smartcat.

4. Double-check that no spaces or special characters are accidentally copied.

1. In ButterCMS, go to Content Types → Page Types.

2. Identify the page types that you want to translate.

3. Click on each page type to open it, then copy the Page Type ID.

4. Paste the ID into the corresponding field in Smartcat’s Create Integration form.

1. In ButterCMS, return to your account settings and open the Localization tab. 

2. Review your active locales (e.g., en, de , es , fr ).

3. In Smartcat, map these locales to their corresponding Smartcat languages.

4. Once all locales are mapped, click Create Integration to finalize the setup.

To start the translation process, simply select your content (for example, an article) and click Create translation.

Select if you want to create a new project in Smartcat or upload a file to the existing project. Enter the project data, such as name, deadline, and source and target language.

You can select multiple target languages.

Select the appropriate workflow for your translation. The Automatic Translation → Post-Editing workflow allows Smartcat to select the most suitable AI engine for the initial translation. After that, you can review the translation yourself or invite a collaborator to your project in Smartcat.

Proceed to the Integration-specific settings by clicking the respective button below. Select the import mode for your translation: to import existing translations or skip this step.

After the synchronization process is complete, you will see a list of target languages under the title of the original file. Click on the underlined title on the left to open your project in Smartcat.

Problem: Smartcat displays an “Invalid API key” or “Authentication failed” message. Solution:

1. Ensure you copied both Read and Write keys correctly.

2. Verify your ButterCMS account permissions include API access.

3. Try regenerating new keys and re-entering them in Smartcat.

Problem: Your expected page types don’t appear in Smartcat. Solution:

1. Confirm that the page type exists and is published in ButterCMS.

2. Check if the Page Type ID was entered correctly.

3. Reconnect the integration if newly created pages were added after setup.

Problem: Some target languages aren’t displaying properly. Solution:

1. Review your ButterCMS Localization tab to confirm all locales are active.

2. Make sure each locale is mapped to a valid Smartcat language code.

3. Re-save the integration to refresh language mapping.

Q: Does the integration support all content types? Currently, it supports Page Types and Collections. Some dynamic modules may require manual syncing.

Q: What happens if I update a page in ButterCMS after integration? I f autosync rules are set up Smartcat will automatically detect and import updates, during the next sync cycle.

By following this guide, you’ve successfully:

1. Linked your ButterCMS account with Smartcat

2. Configured locales and page types

3. Learned how to troubleshoot common connection issues

You’re now ready to streamline your multilingual content process directly between ButterCMS and Smartcat!