Skip to content

Product Media

Managing Product Images

High-quality images are essential for online sales. Cartly makes it easy to upload, organize, and optimize your product media.

Uploading Images

There are two ways to add images to a product:

  • Drag and drop — Drag image files directly onto the media section of the product edit page. Multiple files can be dropped at once.
  • File browser — Click the upload area to open a file picker. Select one or more images.

Supported formats: JPEG, PNG, and WebP. Maximum file size is 10MB per image. For best results, use images at least 1024x1024 pixels.

Image Storage

All uploaded images are stored in S3-compatible object storage and served through a CDN for fast global delivery. Cartly generates presigned upload URLs so your images go directly to storage without passing through the application server, keeping uploads fast even for large files.

Organizing Images

Reorder images by dragging them into the desired position. The first image in the list becomes the featured image — this is the image shown in product listings, collection pages, and search results. Choose your best product photo as the featured image.

Variant Images

You can associate specific images with product variants. For example, if you sell a t-shirt in Red and Blue, you can link the red product photo to the Red variant and the blue photo to the Blue variant. When a customer selects a color on the product page, the displayed image updates automatically.

Alt Text

Add descriptive alt text to each image for accessibility and SEO. Screen readers use alt text to describe images to visually impaired users, and search engines use it to understand image content. Good alt text is concise and descriptive: "Black leather wallet, open view showing card slots."

Deleting Images

Hover over an image and click the delete icon to remove it. Deleted images are removed from S3 storage permanently. If an image is associated with a variant, the variant association is also removed.

Image Best Practices

  • Use consistent aspect ratios across all product images for a clean storefront layout
  • Include multiple angles: front, back, detail, and lifestyle shots
  • Use a white or neutral background for the featured image
  • Optimize file size — WebP format offers the best quality-to-size ratio
Was this helpful?