Translate Content in Bulk

This article explains how to import translated content for an existing document in your Prismic repository.

To import translated content for an existing document, you need to import JSON files with a naming convention based on the grouplang ID.

grouplang ID

The grouplang ID is a common identifier for a document and its translations. A document in the master language and all its translations share the same grouplang ID. You can find the grouplang ID at the end of each JSON file when export documents. It looks like this:

"grouplang": "Xr6nORAAAChEyddY"

Import a new translation for an existing document

To import translated content for an existing document, you need to import files with this naming convention:


For example: If you want to import an "fr-fr" French translation of an existing "en-us" document (for which the grouplang ID is WKq0ph4AACEA4M9B), the JSON file you'll import for the French content needs to be named like this:


The filename has to contain the grouplang ID that you can find in the master language document when exporting it.

Also, make sure you have the right locale code set up in the JSON file itself.

Troubleshooting Singletons

You might see an error when trying to import a translation for a document that is of a Singleton type. In that case, switch the type from Singleton to Repeatable. Once you're done with the import, you can change it back to Singleton. 

Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Get in touch with us on our Community Forum.