Contentstack is a headless content management system (CMS) that helps teams manage and deliver digital content across various platforms. It’s known for its flexibility and ease of use, making it a great tool for content creators and developers.

Use this app to sync your Contentstack data with Lokalise in just a couple of clicks, making localization a breeze.

First, decide which languages you'd like to translate. Head to Contentstack, open your stack, and navigate to Settings > Languages.

Click New language, and you'll see a dialog box like this:

Here, you can either select a predefined language or create a custom one. Once you've made your choice, click Add.

Now, let's integrate Lokalise with Contentstack. Follow these steps:

To generate a new API key and management token, go back to Contentstack and navigate to Settings > Tokens. Switch to the Management tokens tab and click +Management Token.

You'll then see this screen:

Provide a name for the token and select read and write permissions.

Click Generate token, and you'll receive your API key and token:

Copy these values and paste them into the corresponding fields in Lokalise. Be sure to keep these values private and never share them publicly!

Once you're done, return to Lokalise and click Authorize. You'll see an empty content list at first:

Click Refresh list to fetch your data from Contentstack. Whenever you need to retrieve newly created content from Contentstack, simply hit the Refresh button again.

Now that everything is set up, you can choose what content to import from Contentstack to Lokalise. To do this, simply check the boxes next to the items you want to import and click Import selected:

You can also refine your selection by using the search box at the top or creating a custom filter.

After selecting your content, you'll see the following dialog box:

Once you're ready, click OK. The import will run in the background, and a notification will appear once it's complete. You can then proceed to the project editor and begin translating as usual.

After completing your translations, it’s time to export them back to Contentstack. To do this, follow these steps:

You’ll be presented with the following options:

Once you’ve made your choices, click OK. The export will run in the background, and you'll get a notification once it’s finished.

When you define a content type in Contentstack, each field gets a unique ID based on its display name. If you later modify this ID, the Contentstack Lokalise app will generate a new key name, which is critical because the integration relies on consistent key names. However, changing the display name alone won’t affect the existing Lokalise key linkage.

If you modify a field's unique ID in Contentstack, here's what will happen: