ZIP Upload

Use Shot Planner instead. Shot Planner is now the recommended way to bulk-import products into Product Studio: upload your images, let an AI agent draft a plan across your perspectives, review it, and execute. For most catalogs it replaces the ZIP workflow described below.

ZIP upload still works under the hood, but there's currently no Upload ZIP button in the app, the entry point is switched off in production. Treat it as a legacy, secondary method rather than something you can pick up self-serve today. The mechanics below remain accurate if your account still has this method available.

Preparing the ZIP Archive

Folder Structure

Your ZIP must follow this hierarchy:

{product-group}/
  fashion-model.txt
  {product}/
    {perspective}/
      image.[jpg|jpeg|png|webp]

What Each Level Means

Product Group - The top-level folder. Give it any name you like (e.g. summer-collection). Each product group becomes its own Product Studio session. You can have multiple product groups in a single ZIP to process different collections at once.

fashion-model.txt - A plain text file placed directly inside each product group folder. It must contain the UUID of the fashion model you want to use for that group. See Finding the Fashion Model UUID below.

Product - A subfolder within the product group, one per product. The folder name is used as the product title (hyphens are replaced with spaces and the name is capitalized, so red-sneakers becomes "Red Sneakers").

Perspective - A subfolder within each product. The name must be one of:

  • front
  • back
  • other
  • cropped

The name is case-insensitive, so Front and front both work.

Image Files - Place your product images inside the perspective folders. Supported formats are .jpg, .jpeg, .png, and .webp.

Limits

  • Maximum ZIP size: 20 MiB
  • Maximum 6 images per product (across all perspectives combined)

Example

my-import.zip
├── summer-collection/
│   ├── fashion-model.txt
│   ├── red-sneakers/
│   │   ├── front/
│   │   │   └── sneaker-front.jpg
│   │   └── back/
│   │       └── sneaker-back.jpg
│   └── blue-jacket/
│       ├── front/
│       │   └── jacket-01.png
│       └── other/
│           └── jacket-detail.webp
└── winter-collection/
    ├── fashion-model.txt
    └── wool-scarf/
        └── front/
            └── scarf.jpg

In this example, summer-collection and winter-collection are two separate product groups. Each can use a different fashion model. The summer collection contains two products (red sneakers and blue jacket), while the winter collection has one (wool scarf).

Finding the Fashion Model UUID

Each product group needs a fashion-model.txt file containing the UUID of the model to use. You can find this UUID in the URL when viewing a fashion model in the Brandmachine app:

https://admin.shopify.com/store/{your-store}/apps/brandmachine/fashion-models/{MODEL-UUID}/revision/{REVISION-UUID}

For example, in this URL:

https://admin.shopify.com/store/my-store/apps/brandmachine/fashion-models/88F9F63E-0773-4F40-944E-2B3853BC6A83/revision/45909C76-D54C-4F9F-A58B-B0B30A1B4E7C

The fashion model UUID is 88F9F63E-0773-4F40-944E-2B3853BC6A83. Copy this value and paste it into your fashion-model.txt file.

What Happens After Upload

Once you upload the ZIP, the system processes it in the background:

  1. Image analysis - Each product image is analyzed by AI to generate a description
  2. Generation - Product Studio outputs are generated for every configured perspective that matches your uploaded view types
  3. Results - Generated images appear in the Product Studio interface, grouped by the product groups from your ZIP

All generations use 4K resolution, the same as studios created through the normal Product Studio flow or through Shot Planner.

Troubleshooting

"File must be a ZIP archive" - Make sure your file has a .zip extension.

"ZIP file must not exceed 20 MiB" - Reduce image file sizes (e.g. use WebP format) or split into multiple uploads.

"Invalid perspective" - Check that your perspective folder names are exactly front, back, other, or cropped. No other names are accepted.

"Too many images per product" - A product can have at most 6 images total across all its perspective folders.

"Archive contains no valid images" - The ZIP was parsed but no supported image files were found. Check that your images are .jpg, .jpeg, .png, or .webp and that the folder structure is correct.

"Fashion model not found" - The UUID in fashion-model.txt doesn't match any fashion model. Double-check the UUID from the URL and make sure the model exists and is fully trained.

For bulk imports today, start with Shot Planner. If you rely on an existing ZIP-based import and need help, contact support@brandmachine.shop.