Export file format
AI Overview
This page describes what is inside an exported backup .zip file from Backup & Restore Tipo, how large exports are split into groups and parts, and how files are named. It also explains the signature file that confirms an export is genuine and for your store, which matters when you upload a file again with Restore from a file.
View moreView less
- Each zip has a folder per data type with a `data.jsonl` file, plus a `files/` folder for types that include files.
- A signature file proves the export is unedited and from your store; otherwise themes are never restored.
- Unverified files need I reviewed this file and want to restore it anyway ticked for other data.
- Large exports split into groups and parts of about 400 MB, 15,000 entries or 150,000 lines.
- Uploads accept .zip only, up to 200 MB, kept about 24 hours, with 5 uploads per 10 minutes.
Summary generated by AI. It can make mistakes, so check the full guide below.
See what is inside an exported backup .zip file, how large exports are split, and how files are named.
When you download a backup, you get one or more .zip files. This page explains what is inside them, so you can open them, check them, or upload them again with Restore from a file. To create an export, see Download a backup.
What is inside a zip
Section titled “What is inside a zip”Each zip file contains a folder for every data type you selected.
| Path in the zip | What it holds |
|---|---|
{resource}/data.jsonl |
The records for that data type, one per line. For example, products/data.jsonl. |
{resource}/files/ |
The binary files that belong to that data type, such as product images, collection images and files from Content > Files. Present only for data types that include files. |
themes/{themeId}/data.jsonl |
The record of one theme. |
themes/{themeId}/files/ |
The theme’s files, kept in the same folder structure as the theme (assets, templates, locales and so on). |
tipo-export-signature.json |
A signature the app uses to check that the file was exported for your store and not edited. |
On the export page, Products, Collections, Files and Themes show Includes files. These are the data types that add a files/ folder.
Inventory is not part of an export. To download inventory levels, export a CSV from a location’s page. See Export inventory as CSV.
JSON Lines
Section titled “JSON Lines”The data.jsonl files use the JSON Lines format. Each line is one complete JSON record, for example one product. You can open them in a text editor or load them into a tool that reads JSON. Do not reformat them if you plan to upload the file again.
The signature file
Section titled “The signature file”The signature file lets the app confirm that an exported file is genuine, unchanged, and was exported for your store. A file exported from another store doesn’t count as your store’s.
If you upload a file that is unsigned, was edited, was exported for another store, or came from somewhere else, the app shows this warning: “This file was not exported by this app for this store, or it was changed after export. You can still restore its data, but review what it will change first.” For such a file:
- Themes are never restored. The app shows “Themes in this file were left out. A theme can only be restored from an export this app made for this store.”
- Other data can still be restored, but only after you tick I reviewed this file and want to restore it anyway.
- On the restore’s details page in Restore history, the source has an Unverified file badge.
How exports are split
Section titled “How exports are split”A large export is not one huge file. The app splits it into groups, and each group can be downloaded and restored on its own.
| Group label | What it contains |
|---|---|
| Store data | All data types that have no files, together. |
| Products | Products and their media. |
| Collections | Collections and their images. |
| Articles | Blog posts. |
| Files | Files from Content > Files. |
| Theme {id} | One theme. Every theme gets its own zip. |
When a group is large, it is split again into numbered parts. A part is closed when it reaches about 400 MB of uncompressed data, 15,000 entries or 150,000 data lines. Each part is a complete zip you can restore from by itself.
File names
Section titled “File names”| When | File name |
|---|---|
| A single file | backup-{id}.zip |
| A single theme | backup-{id}-theme-{themeId}.zip |
| Several files | backup-{id}-{group}-{number}.zip, for example backup-42-products-001.zip or backup-42-theme-123-001.zip |
Uploading a file again
Section titled “Uploading a file again”You can restore from any exported zip. Select Restore from a file on the Backups page. See Restore from a file.
- Only .zip files are accepted.
- The upload can be up to 200 MB. Each exported part stays within this limit.
- The app keeps an uploaded file for about 24 hours, so restore soon after you upload it.
- You can upload up to 5 files in 10 minutes.