Bulk Image Uploader for Shopify
🔧 Quick Info: Bulk Image Uploader adds product images to Shopify in bulk using a ZIP file of images and a supplemental CSV that matches each image to an existing product variant by SKU.
What It Does
Bulk Image Uploader lets you add images to many Shopify products at once instead of opening each product and uploading its images individually.
You provide two files:
- A ZIP file containing the product images.
- A supplemental CSV file that tells the tool which SKU each image belongs to, the exact image filename, its alt text, and whether it should become the primary image.
The tool reads each row in the CSV, finds the matching image inside the ZIP file, and then searches your Shopify store for a product variant with the listed SKU.
- If the image filename and SKU are both found, the image is attached to the matching product.
- If the row is marked as primary, the image is set as the featured image for the matching variant.
- If either the image or SKU cannot be found, the row is skipped and reported as an error.
One CSV Row per Image: Every image you want uploaded must have its own row in the supplemental CSV. The same SKU can appear on several rows when you are uploading multiple images for one product or variant.
The upload runs as a background job, so you can close the page after starting it. When the upload is complete, the tool sends a confirmation email to the address selected in Notification Settings.
When Should You Use This?
- You are setting up a new Shopify store with a large product catalog.
- You have received a batch of new product photos that need to be attached quickly.
- You need to add several images to many products or variants.
- You want to update image alt text in bulk.
- You want to change featured images across many products in one pass.
- You want to avoid uploading images one product at a time in Shopify.
Before You Get Started
- Gather all image files into one ZIP archive.
- Keep the ZIP file at or below 250 MB.
- Keep each individual image file below 8 MB.
- Prepare a supplemental CSV with one row for every image.
- Keep the CSV file at or below 250 MB.
- Make sure the product variants already exist in Shopify.
- Confirm that the SKUs in the CSV match the variant SKUs in your Shopify store.
- Confirm that every image filename in the CSV matches a file inside the ZIP.
Existing SKUs Required: Bulk Image Uploader matches images to existing Shopify variants by SKU. It does not create products, variants, or SKUs.
Exact Filenames Required: The value in the image name column must match the filename inside the ZIP, including spelling and file extension.
How to Use It
1 Open the Tool
Open Bulk Image Uploader from your Shopify tools list.
2 Upload the ZIP File
On the Upload Images step, upload the ZIP archive containing your product images.
The ZIP can contain images for many products and variants, as long as each image is listed in the supplemental CSV.
3 Upload the Supplemental CSV
Upload the CSV file that describes the images inside the ZIP.
The CSV must contain one row per image and include fields for SKU, image name, alt text, and primary image status.
4 Map the CSV Columns
After the CSV is uploaded, match each spreadsheet column to the corresponding Bulk Image Uploader field:
- SKU
- Image Name
- ALT
- Primary Image
All four fields are required.
5 Confirm Notification Settings
Continue to Notification Settings and confirm the email address that should receive the completion notice.
The email address associated with your account is filled in by default, but you can change it.
6 Start the Upload
Submit the tool. A confirmation appears to let you know the image upload has started.
The images are processed in the background, so you do not need to keep the page open.
7 Review the Results
When the upload is complete, check your email for the confirmation notice.
If any rows failed, review the reported errors, correct the ZIP or CSV, and upload the affected rows again.
File Size Limits
| File | Maximum Size |
|---|---|
| ZIP Archive | 250 MB |
| Individual Image | Under 8 MB |
| Supplemental CSV | 250 MB |
Supplemental CSV Reference
The supplemental CSV must contain one row for every image you want to upload. All four fields below are required.
| Field | Required? | What It Does |
|---|---|---|
sku |
Yes | The SKU of the Shopify product variant that should receive the image. |
image_name |
Yes | The exact filename of the image inside the ZIP, including the file extension, such as shirt-front.jpg. |
alt |
Yes | The descriptive alt text saved with the image. |
primary |
Yes | Set this to true when the image should become the primary or featured image. Use a value other than true for additional images. |
Example CSV
| sku | image_name | alt | primary |
|---|---|---|---|
| SHIRT-BLUE-M | shirt-blue-front.jpg | Front view of blue shirt | true |
| SHIRT-BLUE-M | shirt-blue-back.jpg | Back view of blue shirt | false |
| SHIRT-RED-L | shirt-red-front.jpg | Front view of red shirt | true |
How Images Are Matched
Each CSV row must pass two checks before the image can be uploaded:
- The value in
image_namemust match an image inside the ZIP. - The value in
skumust match a product variant in Shopify.
| Match Result | What Happens |
|---|---|
| Image and variant SKU found | The image is attached to the matching Shopify product. |
| Image and SKU found, primary is true | The image is attached and set as the featured image for the matching variant. |
| Image not found in ZIP | The row is skipped and reported as an error. |
| Variant SKU not found in Shopify | The row is skipped and reported as an error. |
Primary Images
The primary field determines whether an uploaded image should become the featured image for the matching variant.
| Primary Value | Result |
|---|---|
true |
The uploaded image is set as the primary or featured image for the variant. |
| Any value other than true | The image is attached as an additional product image but is not set as primary. |
Review Primary Values: Make sure only the intended featured image is marked as true for each product or variant.
Troubleshooting and FAQ
The error says “Image not found in zip file”
The value in the CSV’s Image Name field does not match an image inside the ZIP.
Check the spelling, capitalization, spaces, and file extension. For example, shirt.jpg and shirt.jpeg are different filenames.
The image was not processed because the SKU was not found
The SKU does not match an existing product variant in your Shopify store.
Confirm that the variant exists and check the SKU for typing errors, extra spaces, punctuation differences, or missing characters.
Some images uploaded and others did not
Successful rows are processed even when other rows contain errors.
Review the per-row error details. The most common causes are a mismatched image filename or a SKU that does not exist in Shopify.
The wrong image became the featured image
Review the Primary Image values in your supplemental CSV. The image that should be featured must be marked as true.
The ZIP file will not upload
Confirm that the file is a valid ZIP archive and that its total size does not exceed 250 MB.
Also confirm that every individual image inside the archive is smaller than 8 MB.
My upload is still running
Uploads run as background jobs. Large ZIP files and large numbers of images take longer to process.
You can close the page and wait for the completion email at the address selected in Notification Settings.