PrestaShop Image Sizes
Image types, resize modes and when to regenerate.
Last updated
PrestaShop takes a different approach from most platforms: instead of a fixed set of sizes, you define your own "image types" under Design → Image Settings, each with a name, a width, a height, and the content it applies to, whether that is products, categories, manufacturers or suppliers.
You upload one master image per product and PrestaShop derives every declared type from it. That makes the upload resolution the single most important decision: it has to be large enough to feed the biggest type you have declared, or that type will be upscaled and soft.
Two settings are easy to miss. The resizing method decides whether an image fills by height, by width, or automatically to maximise the frame. And the high-density option generates a second file at double resolution for retina screens, which is useful, but it doubles the storage and regeneration time for your whole catalogue.
PrestaShop image requirements
| Image types | User-defined per content type (product, category, manufacturer) |
|---|---|
| Where to configure | Design → Image Settings |
| Resizing methods | Height, Width, or Automatic |
| Recommended format | JPEG for photos; quality 80 or above |
| Retina support | Optional 2× file generated per image |
| Recommended upload | At least 2× the largest declared image type |
Source: PrestaShop 9: Image Settings, PrestaShop 8: Image Settings
How to do it
- 1Check the largest image type declared under Design → Image Settings.
- 2Resize your masters to at least double that dimension so retina generation has headroom.
- 3Export as JPEG at quality 80–85, or WebP if your theme and server serve it.
- 4Upload, then regenerate thumbnails from the Image Settings page.
Frequently asked questions
What size should PrestaShop product images be?
There is no single answer because you declare the sizes yourself. Work backwards: find the largest image type in Design → Image Settings and upload at least double that dimension so the high-density variant has real pixels to use.
Why is regenerating thumbnails so slow in PrestaShop?
PrestaShop regenerates every declared image type for every product, and doubles that count if high-density images are on. Feeding it smaller masters (1600–2000 px rather than full camera resolution) is the most effective fix.
Should I use JPEG or PNG in PrestaShop?
JPEG for photography; PNG only when you genuinely need transparency. PrestaShop's own documentation recommends keeping JPEG quality at 80 or above, since below roughly 75 compression artefacts become visible on product detail.
Does PrestaShop support WebP or AVIF?
Recent versions and most modern themes can serve WebP, often through a module or your CDN rather than core. Verify on a staging shop before converting a full catalogue, and keep JPEG fallbacks for older clients.
What is the image resizing method setting?
It controls how an image fills its declared frame: "Height" fills the frame height and recalculates width, "Width" does the reverse, and "Automatic" maximises the space the image can occupy. All three preserve the original aspect ratio.