Skip to main content

Images and Assets

Upload product images to cloud storage​

Where to find it: Admin → Products → [Product Details] → Images tab

When you'd use this: When adding or updating product images. All images uploaded through the admin are automatically stored in cloud storage and served from your store's domain.

What you need first:

  • PRODUCT_WRITE permission for the catalog
  • A product already created in your catalog

How it works:

When you upload product images through the admin, they're automatically:

  • Stored in cloud storage (not on local servers)
  • Served from your store's own domain name
  • Registered in the Digital Asset Manager for visibility
  • Tagged with metadata linking them to the specific product
  • Assigned a unique version identifier to ensure browsers and CDNs display the latest image

Image types:

  • Main image — The primary product photo shown on product listings and detail pages
  • Supporting images — Additional photos shown in the product gallery

Working with images:

  1. Add a new image: Upload through the product detail page. If the product doesn't have a main image yet, the first image you upload automatically becomes the main image. Additional images become supporting images.

  2. Replace the main image: Upload a new image and set it as the main image, or use the "Set as main" option on an existing supporting image. When you upload a replacement image, a new version identifier is automatically generated so the updated image displays immediately across all browsers and devices.

  3. Reorder supporting images: Drag and drop supporting images to change their display order in the product gallery. Supporting images are numbered starting at 1, with lower numbers appearing first in the gallery.

  4. Update image alt text: Edit the alt text field to improve accessibility and search optimization.

  5. Delete an image: Remove supporting images using the delete option. Main images can be replaced but the product must always have at least one image.

How image caching works:

Product images are delivered through a content delivery network (CDN) for fast loading. When you upload or replace an image, the system automatically generates a unique version identifier that's added to the image URL. This ensures that browsers and the CDN immediately fetch the new version instead of showing a cached older version.

The version identifier appears in the image URL as a query parameter (e.g., ?v=fa29zsd4). You don't need to manually manage these identifiers — they're created and updated automatically whenever you upload a new image.

Finding product images in the Digital Asset Manager:

Product images appear in the Digital Asset Manager but are filtered out of the default view to keep the interface manageable. Use the product image filter to show them when needed. Each image includes tags identifying:

  • Which product it belongs to (format: productImage:productCode001)
  • The image format or type (format: productImageFormat:cartThumbnail)

Technical details:

Images are stored with metadata flags that distinguish cloud-hosted images from older images that may still reside on legacy servers. The system handles both types seamlessly — you don't need to migrate or convert existing images unless you want to update them.