How to Import Content

This article explains how to import documents into your repository.


The Import/Export tool is available starting on the Medium Plan. More about pricing.

In this article, we will cover the most common use-cases for Prismic's Import tool:

  • import new content,
  • bulk updates of existing documents,
  • and bulk translations.

Import new documents

Here are the following steps to import one or more new documents to your repository:

  1. Prepare each new documents as a JSON file according to your Custom Type for the import, as described in the Import JSON Reference.
  2. Select all the JSON files and compress them directly. Do not compress the folder they are in. Directly select all the files and compress them. Give the compressed file any name.
  3. In your repository, go to Settings > Import/Export > Import your documents.
  4. Click on Choose files and upload the compressed JSON files.
  5. Click Import now. All of your documents will be uploaded and added to a new release. You can give a name to the release, or else it will be auto-named.
  6. Review your new release before publishing. If anything was not imported correctly, you can either edit the documents directly or delete the release and start again.

Once an Import release is published, there is no bulk rollback. Make sure to do the necessary testing before publishing the release.

Update an existing document

Here are the steps to update an existing document:

  1. Export the document.
  2. Make changes in the exported JSON.
  3. To re-import documents, select the JSON files and compress them directly. Do not compress the folder they are in. Directly select all the files and compress them.
  4. In your repository, go to Settings > Import/Export > Import your documents.
  5. Click on Choose files and upload JSON files.
  6. Click Import now. All of your documents will be uploaded and added to a new release. You can give a name to the release, or else it will be named automatically.
  7. Review your new release before publishing. If anything was not imported correctly, you can either edit the documents directly or delete the release and start again.

Do not change your documents' file names before re-importing them.

Limitations of Import

  • The Import module lets you upload a ZIP archive containing up to 200 JSON files, each file representing the content for one Prismic document. Import jobs are limited to 10 per hour.
  • You can not import files (other than image files) along with your export jobs.
  • When pointing to a media file (media URL or local file path) in your import JSON files, those files will be added to the media library of your repository as soon as you launch the Import job. If you delete the Import release after launching the Import job, media files will remain in the media library of your repository. This means that retrying Import jobs several times could lead to duplicates in the media library. Find out how to avoid duplicates by referring to the Images section of the Import Reference
  • You will lose image positioning and crop in the Import job. You need to re-apply these.

Use cases


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.