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

Imports must be a ZIP file containing one JSON file for each Document.

  • You can import up to 200 Documents.
  • Import jobs are limited to 10 per hour.
  • The ZIP file size limit is 100MB.
  • The individual JSON file limit is 250000 bytes.
  • You can only import image-type files
  • You cannot add copyright or private note fields to Images.
  • 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.
  • The import automatically regenerates thumbnails based on the `origin` data for the main image specified in the Import JSON file. Thus, the image data you provide in Import JSON files for responsive views of a given Image field are ignored in the importing job.
  • Any Content Relationship or Link to another Prismic document will need to be re-added after the import has been done.

Use cases


Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Spot an error in the documentation? Get in touch with us on our Community Forum or using the feedback form above.