ZIP Upload

ZIP Upload is the most efficient way to add multiple products with images to merchi.ai. Package your product images in a ZIP file and upload them all at once.

Preparing Your ZIP File

File Naming Convention

Name your image files using your Product ID (SKU) followed by an underscore and a sequential number:

my-products.zip
├── SKU1234_1.jpg
├── SKU1234_2.jpg
├── SKU1234_3.jpg
├── SKU5678_1.jpg
├── SKU5678_2.jpg
├── SKU5678_3.jpg
└── PROD999_1.png

Naming Rules

• Product ID: The part before the underscore becomes your Product ID (e.g., SKU1234)
• Image Number: The number after the underscore determines the image order (e.g., _1, _2, _3)
• The first image (lowest number) becomes the primary image
• Use your existing SKU or product codes
• Keep product IDs unique
• Avoid special characters in product IDs (except hyphens and underscores)

Image Files

Supported image formats:

• JPEG (.jpg, .jpeg)
• PNG (.png)
• GIF (.gif)
• WebP (.webp)
• AVIF (.avif)
• TIFF (.tif, .tiff)
• BMP (.bmp)
• SVG (.svg)

Image recommendations:

• Minimum 800x800 pixels
• Maximum 4000x4000 pixels
• High quality for best AI analysis
• Multiple angles help generate better descriptions

Uploading

Upload Process

1. Go to Add Products or the home page
2. Select ZIP Upload
3. Drag and drop your ZIP file, or click to browse
4. Wait for upload to complete
5. Processing begins automatically

Upload Progress

During upload you’ll see:

• Upload percentage
• File size progress
• Estimated time remaining

Processing Status

After upload, products are processed:

• Starting: Upload received, preparing
• Counting: Counting products in ZIP
• Running: AI is analyzing images
• Finished: All products processed

Check the All Products View for processing alerts.

Best Practices

Optimize Your Images

• Compress images to reduce upload time
• Remove unnecessary metadata
• Use consistent image dimensions

Test First

• Start with a small batch (5-10 products)
• Verify the output meets expectations
• Adjust your Writing Knowledge if needed
• Then process larger batches

Image Quality

• Better images = better descriptions
• Show product clearly
• Include different angles
• Avoid blurry or dark images

Troubleshooting

Upload Fails

• Check file size (max 500MB per ZIP)
• Ensure ZIP is not corrupted
• Try a smaller batch
• Check internet connection

Missing Products

• Verify file naming convention is correct (SKU_number.jpg)
• Check for hidden files in the ZIP
• Ensure images are in supported formats (JPEG, PNG, GIF, WebP, AVIF, TIFF, BMP, SVG)

Poor Content Quality

• Review your Writing Knowledge settings
• Improve image quality
• Add more product images
• Provide clearer images of labels/features

After Upload

Once processing completes:

1. Go to All Products View
2. Filter by recent products
3. Review generated content
4. Approve, edit, or reject as needed