PrestaShop product image requirements
PrestaShop product images: one master upload resized to the theme's sizes (500 × 500 large image in the sample theme); JPEG or PNG, WebP and AVIF from 8.1.
All PrestaShop image requirements
Source: PrestaShop 9 documentation — Image Settings; Managing Products; PrestaShop Developer Documentation — Creating a theme from scratch; PrestaShop Help Center — Optimize the images; PrestaShop project news — PrestaShop 8.1 beta is open for feedback!; PrestaShop 9 is available. Checked 12 October 2026. Read again · 12 October 2026
- Upload
- Only one master version of each image is uploaded; PrestaShop generates every smaller size from it, so it must be big enough to be resized into all image sizes
- Size
- The theme declares the image sizes; the developer documentation's sample theme.yml uses 500 × 500 pixels for the large product image and 250 × 250 pixels for the home listing image
- Aspect ratio
- The upload should have the same width-to-height ratio as the configured image sizes, otherwise whitespace can appear on the resized image
- Formats
- Generated images are saved as JPEG or PNG; version 8.1 added multiple-format image generation (WebP, AVIF), and PrestaShop 9 lists native support for both formats; JPEG is the recommended choice for generated images
- Compression
- JPEG compression should not be set below 80, or at worst 75; PNG compression should not be set over 6, or at worst 7
- Customer uploads
- The maximum file size of product customization pictures, which customers upload, defaults to the server's PHP maximum setting and can be expanded if PHP accepts uploads of that size
- Cover image
- The first uploaded image is the default cover image and appears on the product page; any other image can be set as the cover
- Alt text
- Each image's caption is used as its alt attribute and should be translated for every language of the shop
- Optimisation
- The Help Center advises not using images larger than the size needed, giving 1,024 × 1,024 pixels as its example, and preferring WebP, then JPG and PNG
What PrestaShop asks for, covered.
PrestaShop takes one master upload of each image and generates every smaller size from it, so the upload has to be big enough for all of the theme's image sizes. Square 2K output is 2,048 × 2,048 pixels, above the 500 × 500 pixels the sample theme in PrestaShop's developer documentation uses for the large product image. An upload whose ratio differs from the configured image sizes can get whitespace on the resized image, so a collection ordered in the ratio the theme uses avoids it. Herofab images can be downloaded as PNG or JPG.
One master image
PrestaShop generates every image size from a single upload; square 2K output is 2,048 × 2,048 pixels.
Match the theme's ratio
An upload whose ratio differs from the configured image sizes can get whitespace on the resized image.
PNG or JPG
Herofab images can be downloaded as PNG or JPG.
PrestaShop, answered.
What size should PrestaShop product images be?
PrestaShop product images: one master upload resized to the theme's sizes (500 × 500 large image in the sample theme); JPEG or PNG, WebP and AVIF from 8.1.
Which file formats does PrestaShop accept for product images?
Generated images are saved as JPEG or PNG; version 8.1 added multiple-format image generation (WebP, AVIF), and PrestaShop 9 lists native support for both formats; JPEG is the recommended choice for generated images. Source: PrestaShop 9 documentation — Image Settings; Managing Products; PrestaShop Developer Documentation — Creating a theme from scratch; PrestaShop Help Center — Optimize the images; PrestaShop project news — PrestaShop 8.1 beta is open for feedback!; PrestaShop 9 is available, checked 12 October 2026.
Can I check my images before uploading?
Yes. The free image size checker reads each file in your browser and tests it against these rules; the image is not uploaded.
Where do these figures come from?
From PrestaShop 9 documentation — Image Settings; Managing Products; PrestaShop Developer Documentation — Creating a theme from scratch; PrestaShop Help Center — Optimize the images; PrestaShop project news — PrestaShop 8.1 beta is open for feedback!; PrestaShop 9 is available, read on 12 October 2026. Marketplaces update their rules; the official page is the final reference.
Your next collection, shot this week.
20 credits at sign-up, no card required. Images made with free credits carry a watermark. Herofab also removes the watermark from those images once credits are purchased.
