Example of an export ZIP from Prismic

I am heading to a complex content migration going from legacy slices to the not-so-new system :slight_smile:

Complex because my legacy slices are pretty sofisticated and i can just imagine what a pain it must be to translate this thing to anything.

After some research it appears that documentation does not actually show the structure of an export ZIP from Prismic :

  • What si exactly inside this archive ?
  • How json files are formatted ?
  • How old slices are formatted vs new slices ?
  • What about the images ? Are there any filenames changes ?

Without those informations i cannot estimate if this "automated" process is, in my case, a dead-end and if i'd better reinsert everything by hand.

My question : Is there a documentation somewhere about the exact content of those archives ?

Cheers !

Hello, we have a dedicated article that explains how to do it, have you seen it yet?

Regarding your questions:

  1. When you do an export of your documents you get a JSON file for each single It generates a ZIP archive containing a JSON file for each of the documents that are published in the repository. Only published documents are exported. Drafts and documents stored in a Release are not exported.
  2. The JSON has all the fields that your documents, modeled by your custom types, use. This exact format is the same you should use when Importing documents. You can check out the full Import / Export reference to understand how each field should be modeled in the JSON.
  3. In the first article that I shared with you before it shows you how you can achieve this. Basically you need to model your old Custom types into new ones that use new Slices, create simple published documents that use those Custom types, and them export them so you can see how the JSON is formatted, that way you can know how you'll need to write the import files.
  4. The images should be imported as normally depending if you already have them in your repo, if they're in your machine or if they are online. Read Importing images.

Thank you so much Paulina.

There is a few docs in your post that i haven't seen.


1 Like

This topic was automatically closed 24 hours after the last reply. New replies are no longer allowed.