Skip to content

Import & Export

Move diagrams between stores or back them up offline. The app exchanges diagrams as a single JSON file containing all hotspots, labels, mapped product handles, and image references.

Open via Diagrams → Import & Export.

Export

  1. Pick one or more diagrams from the list (or Export all).
  2. Click Export. The browser downloads a .json file.
  3. Optionally also download the image assets as a separate .zip.

The JSON file includes:

  • Diagram name and dimensions.
  • Hotspot list with normalized coordinates, labels, and product handles.
  • Variant mapping snapshots (price, SKU, title) at export time.

It does not include:

  • Live storefront analytics.
  • Internal team notes (these are per-store).
  • The image asset itself (download separately as the .zip).

Import

  1. Click Import, drop the JSON file (and optional asset .zip).
  2. The dialog previews the diagrams and reports:
    • Hotspots whose product handles match existing products on this store.
    • Hotspots whose handles don't match — you can manually remap them now or leave them blank to fix later in the editor.
  3. Click Import.

Imported diagrams are created as new entries — never overwriting existing ones — and start as Unassigned.

Use cases

Situation Approach
Migrating a diagram from a dev store to production Export from dev (with assets), Import on prod, assign to the same products
Backing up before a large catalog edit Export all, store the JSON in your team's drive
Building diagrams in a sandbox and shipping to the live store Same workflow — export + import

Variant snapshots may go stale

Exported snapshots reflect prices and stock at the moment of export. On the destination store, the Parts Diagram block always reads live Shopify data on the storefront, so the snapshot only affects the initial paint. If the destination store has very different prices, expect a flash of imported data before the live values arrive.