Skip to content

Search guides for Backup & Restore.

    Download MarkdownSave a copy of this guide

    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.

    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.

    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 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.

    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.

    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

    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.