NotShot Blog

CS-Cart product image size for clothing (2026)

Published 2026-11-01

CS-Cart is an ecommerce platform that stores run on their own server or on CS-Cart cloud hosting. It never shows your original upload on the storefront. Instead, it builds thumbnails at the sizes you set in the admin panel. This page collects what the official CS-Cart 4.21.x docs say about product images, with the date we checked them, and turns that into settings for clothing photos. We make NotShot, an AI on-model photo tool, so we also cover where on-model images fit.

Close crop of a man in a heather light gray crew neck sweatshirt, from the nose down to the chest, against a plain light gray background. The ribbed neckline and the soft knit texture are visible.
An on-model render made with NotShot, 1182×1600 pixels and about 404 KB. That is under the 3,000 pixel and 1 to 2 MB limits in the CS-Cart docs. In a 600 × 600 thumbnail box, CS-Cart would scale it to about 443 × 600 pixels and pad both sides.

What the CS-Cart docs recommend

The CS-Cart docs page on the best images for your store (CS-Cart 4.21.x, checked by us on 1 November 2026) recommends:

Hard limits are set by the store. The Image file size field under Settings, General, Thumbnails caps uploads in megabytes, and if it is empty, the server's PHP upload settings apply. A tweak called max_uploaded_image_dimension in config.local.php can also reject images wider or taller than a set number of pixels, 6000 in the docs example. The CS-Cart product properties page adds that an upload should, as a rule, not exceed 2 MB.

Where CS-Cart sets image sizes

The Thumbnails settings page in the CS-Cart docs lists a width and a height for each place a product image appears:

The same page sets the thumbnail background color, the thumbnail format (keep the original, or convert to GIF, JPEG or PNG) and the JPEG format quality. For quality, the docs recommend no less than 60 and call 80 optimal in most cases. After you change these settings, go to Website, Themes and click Clear thumbnails so CS-Cart builds them again.

How CS-Cart fits a portrait photo into the box

The CS-Cart docs page on changing image size describes what happens to each upload:

Nothing is cropped, so heads and hems stay in the frame. But a full length photo of a standing model in a square box gets padding on the left and right. For clothing, either set the width and height to the shape of your photos, such as a 3:4 portrait pair, or export square photos with the garment centered on a background that matches your thumbnail background color. The docs warn that setting only one dimension makes thumbnails vary in size, so the product grid may look uneven.

Formats

The product properties page lists JPEG, GIF and PNG for product images. The image guide also covers WebP, which needs WebP support enabled in the server's GD or Imagick library, and says that in most cases JPEG is the best format for ecommerce. It advises against GIF for large images and suggests care with PNG, since full color PNG files are much larger. For on-model clothing photos, JPEG is the safe pick.

Main image, gallery and zoom

On the product editing page, one uploaded image appears larger than the others. That is the main image, shown in the product list and on the product details page by default. Drag another image into its place to change it, and reorder the additional images the same way. Hover over an image to edit its alt text, which the docs recommend for SEO. In the Nova theme, the product list works as a hover gallery that shows up to 6 images, main image first, and as a swipe slider on phones.

The Image Zoom add-on, installed by default, lets shoppers zoom product images by hovering. Zoom only helps if the upload is larger than the product page thumbnail, so leave headroom while staying inside the size limits above.

CS-Cart image checklist for clothing

  1. Box shape: set the product list and product details sizes to the shape of your photos, or export square photos.
  2. Size: at least your product details size, at most 3,000 pixels on the longest side.
  3. File: JPEG, 1 to 2 MB or less.
  4. Background: match your thumbnail background color, so padding blends in.
  5. Main image: the best front or on-model view, in the main image slot.
  6. Additional images: back, side, detail and color views, each with alt text.
  7. After changes: Website, Themes, Clear thumbnails.

Running another platform too? Compare OpenCart product image size for clothing, PrestaShop product image size for clothing and Odoo eCommerce product image size for clothing. Running Saleor too? See Saleor product image size for clothing. For lighting and backdrops, see our clothing product photography guide.

Where NotShot fits

The CS-Cart docs set no rule against models in product images, so on-model photos can sit next to your packshots as the main or additional images. Check each marketplace's own rules before you sell there. NotShot renders your garment on your own model from the product photo you already have, and every render is checked by an AI judge that compares it with your upload for color, print and cut. Renders below the quality bar are refunded automatically, so you pay for photos that pass the check, not for attempts. Plans are on the pricing page.

Questions we get asked

What image size should I upload to CS-Cart for clothing?
The CS-Cart 4.21.x docs recommend uploads of 300 x 300 to 600 x 600 pixels depending on where the image is used, at most 3,000 pixels on the longest side and at most 1 to 2 MB per file. For clothing, upload at least the size you set for the product details page thumbnail, so the main image stays sharp.
Where do I set image sizes in CS-Cart?
In the admin panel, go to Settings, General, Thumbnails. You set a width and a height for the product list, the product details page, quick view, the cart page and the categories list, plus the maximum upload size, background color, thumbnail format and JPEG quality.
Why do my CS-Cart clothing photos have padding on the sides?
When both width and height are set, CS-Cart scales a larger image down, keeps its aspect ratio, centers it and fills the rest with the thumbnail background color. A tall photo in a square box gets padding on the left and right. Set only one dimension to avoid padding, though the docs warn the product grid may then look uneven.
Which image formats does CS-Cart accept?
The CS-Cart product docs list JPEG, GIF and PNG. The CS-Cart image guide adds WebP, which needs WebP support in the server's GD or Imagick library, and says JPEG is the best format in most ecommerce cases.
How do I change the main product image in CS-Cart?
On the product editing page, drag another image into the place of the larger main image. You can reorder the additional images the same way and edit each image's alt text by hovering over it.

NotShot is a Berlin-based tool for on-model product photography without the photoshoot.
Try NotShot