Say a merchant sends image files for a new Shopify catalog: 300 products, each with three to six files named IMG_0001 through IMG_0900. Shopify image uploads for a new catalog cannot start efficiently until one decision is in place: a naming convention. Getting that standard set before the first product goes in prevents the rework that follows when it is left until batch 50.
Key takeaways
- Shopify accepts JPEG, PNG, WEBP, HEIC, and GIF image files up to 20 MB and 25 megapixels per file, with a maximum of 250 images per product (as of November 2026).
- For a new catalog, naming conventions and required angles must be agreed before the first file is processed, because changing them later means updating references across every product already in the store.
- SKU-based file names (for example
SHIRT-001-BLU-FRONT.jpg) let an upload team match images to products without a manual lookup; generic names likeIMG_0003.jpgrequire a hand-match for every file. - Shopify lets you assign one featured image per variant from the product's image gallery, so each color or style option shows the right image when a customer selects it.
- A one-page image brief given to both the photographer and the upload team before the job starts removes most common delays in a first catalog.
How Shopify image uploads work for a new catalog
Starting a catalog from scratch means there is no naming history to reference and no previous batches to compare against. This is an advantage: an upload team can set the standard from day one instead of working around existing inconsistencies.
Before any file reaches Shopify, a team reviews the incoming image folder for format, file size, and naming. The first two are straightforward.
File format. Shopify accepts JPEG, PNG, WEBP, HEIC, and GIF (as of November 2026, per the Shopify Help Center). RAW, TIFF, and PSD files don't upload directly. If the photographer has delivered RAW files, those go back for export before the upload job can start.
File size. Each image can be up to 20 MB. Most compressed JPEGs from a product photographer are well inside this. The problem usually comes from large TIFF exports or uncompressed PNGs. One line in the brief fixes it: "JPEG or WEBP, under 20 MB per file."
File names. This is where most batch holds in a new catalog originate. See the naming section below.
For a Shopify product uploading job, images are added to a product after the product record is created. The team uploads images to the product's gallery in Shopify admin, then assigns one image to each variant if the product has multiple options (see the variant image section below).
The product images standards article covers what a team checks on receipt for any batch. This article covers the founding decisions that only exist when a catalog is being built from scratch: the ones that set the template every future batch follows.
Setting image naming conventions for a new catalog
When a new catalog has no naming convention yet, the upload team needs to agree on one before the first batch is processed. Not because Shopify requires a particular name format (Shopify renames files on its CDN, so the original file name doesn't appear in the final product URL), but because consistent names are what make image-to-product matching fast.
Files named IMG_0001.jpg through IMG_0300.jpg require a team member to open each file, check which product it shows, and find the matching product row. Files named with the SKU and an angle code (for example, SHIRT-001-BLU-FRONT.jpg) match automatically.
A workable naming convention for a new Shopify catalog follows this structure: [SKU]-[angle or color code].[format]. Here is how that might look across a small clothing store:
| File name | What it shows |
|---|---|
SHIRT-001-FRONT.jpg | Shirt 001, front-on shot |
SHIRT-001-BACK.jpg | Shirt 001, back shot |
SHIRT-001-BLU-FRONT.jpg | Shirt 001, blue colorway, front |
SHIRT-001-RED-FRONT.jpg | Shirt 001, red colorway, front |
The angles you define at this stage become the required angles for every product type in the catalog. A T-shirt might need front and back. A sneaker might need side, heel, toe, and sole. Setting this in writing before the photographer starts means every product arrives with the same coverage, with no gaps that hold up the upload.
For product image optimization as part of an upload, the team also checks that images are consistent in background, dimension, and composition across the catalog, which matters especially when every product will appear side by side in collection grid views.
Matching images to variants in a new catalog
Once images are in a product's gallery in Shopify admin, the team assigns one featured image to each variant. For a shirt with four colors, there are four images in the gallery (one per color), and each variant points to the right one.
In Shopify, variant image assignment is done through the variant editor. As of November 2026, each variant has an option to set which image from the gallery appears when a customer selects it (per Shopify's guide on adding images to variants).
For a new catalog, the team needs to confirm one thing before this step: which product option determines the variant image. Usually it is color or style. If a shirt comes in four colors and three sizes, the size doesn't get its own image. The same color image covers all three sizes of that color.
This is worth confirming with the merchant before the upload starts. Some stores want per-size images for products where the size changes the visual (for example, a folding chair that looks different in a child versus adult version). Most don't. Getting this wrong means re-assigning every variant image in the catalog after the fact.
For a new store, the simplest approach is to agree on a single rule: "One image per color. Sizes share the color image." Put it in the brief and apply it consistently from product one.
What to include in an image brief for a new catalog
An image brief is a single document the merchant gives to both the photographer and the upload team before the catalog starts. It prevents the two most common delays in a new catalog upload: images that arrive in the wrong format, and images that arrive with names that don't match anything in the product list.
A complete image brief covers these five items:
| Brief item | What to specify |
|---|---|
| File format | JPEG or WEBP, under 20 MB per file |
| Naming convention | SKU, then angle or color code, then format (for example SHIRT-001-BLU-FRONT.jpg) |
| Required angles | Minimum angles by product type (front and back for apparel, main view and detail for home goods) |
| Variant image rule | Which option determines the variant image (usually color or style) |
| Background and style | White, gray, or lifestyle, consistent across all products in the catalog |
For more on what to prepare before handing a catalog to an upload team, see what to send your upload team before a Shopify job. That guide covers the full product data side of the brief: variant structure, SKU format, pricing, and collection assignment, which the image brief sits alongside.
For the new store product setup that follows image uploads, Shopify product setup for a new store launch covers how a team builds the catalog structure before the first products go live.
Frequently asked questions
What image format should I use for a new Shopify catalog?
JPEG or WEBP works for most catalogs. Shopify accepts JPEG, PNG, WEBP, HEIC, and GIF files up to 20 MB each (as of November 2026). WEBP gives smaller file sizes at similar quality, which speeds up page loads. If your photographer delivers RAW or TIFF files, they need to be exported to JPEG or WEBP before the upload team can process them.
Does the image file name matter in Shopify?
Shopify renames files on its CDN, so the original name doesn't appear in the final product URL. But the name matters during the upload job itself. An upload team uses the file name to match each image to the right product and variant. SKU-based names (for example SHIRT-001-BLU-FRONT.jpg) make this fast. Generic names like IMG_0032.jpg require a manual check for every file, which slows a large catalog significantly.
How do variant images work in Shopify?
Each variant in Shopify can have one featured image assigned from the product's image gallery. When a customer selects a color or style option, Shopify displays the image linked to that variant. The upload team sets this by opening the variant editor in Shopify admin and selecting the right image for each option value. For a new catalog, confirm which option determines the variant image (usually color) before the job starts.
How many images can a Shopify product have?
Shopify allows up to 250 images per product (as of November 2026). For most catalog products, 3 to 6 images per product is enough to show the main angles and significant color options. Products with many colors may need one image per color, which is worth planning for in the naming convention before the job starts.
What is the difference between image uploads for a new catalog and a batch update?
A new catalog requires founding decisions that a batch update does not: naming conventions, required angles by product type, variant image rules, and background consistency standards. A batch update adds images to existing products that already have these standards in place, so the team applies them rather than setting them. Getting the founding decisions in writing before the first batch is what makes all subsequent batches straightforward.
