Image Settings

The "Images settings" page enables you to configure the various image sizes that your customers will see in your shop. By default, all images settings are already installed in your store. Do not delete them, you will need it!

When you upload an image on PrestaShop, PrestaShop automatically generates various sizes of this image, including thumbnails and other smaller versions of your image. Therefore, you only have to upload one "master" version of your image, big enough to be resized into all the images sizes.

If you want to make sure your image is correctly resized, you should upload an image that fits the size ratio of the various image sizes. If your uploaded image does not have the same width-to-height ratio than the settings in place, you are taking the risk to see whitespace on the resized image.

You can enable image size for specific types of content, directly in the image sizes list.

When you add a new theme to your store, the theme will add itself the image sizes it needed. By default, the page displays image sizes from the default Classic theme.

Add New Images Type

You can easily add a new image size, and even set to which type of content it applies.

Click the "Add new image type" button, then:

  1. Type the size's name, width, and height.

  2. Choose to which type of content it applies.

  3. Save.

Images preferences

  • Image format. You have the choice between two of the major file formats: JPEG and PNG. Both are well established among browsers. JPEG has a good compression ratio but can result in visible artifacts. PNG's compression algorithm is not as good as JPEG's, but there are comparatively fewer visible artifacts; nonetheless, older browsers might not recognize this format. Choosing between one and the other is often a matter of taste. That being said, JPEG remains the recommended choice. If you would rather prevent information loss because of a format change, choose the second option, "Use PNG only if the base image is in PNG format".

  • JPEG compression. Do not choose anything below 80 or at worst 75, for fear of visible compression artifacts.

  • PNG compression. Do not choose anything over 6 or at worst 7, for fear of visible compression artifacts.

  • Generate images based on one side of the source image. This feature allows you to position the product image in its pre-established space:

    • Choose "Height" in order to fill the frame height (the width is then recalculated to maintain the same height/width ratio as in the file of origin).

    • Choose "Width" so that the image fills the width of the frame (the height is then recalculated to maintain the same proportion).

    • Choose "Automatic" so that the width and height are calculated to maximize the space it can occupy in the frame.

  • Maximum file size of product customization pictures. Your customers can upload pictures for customized products. By default, PrestaShop sets this value to the PHP maximum setting – this can mean several megabytes: for instance, 8,388,608 bytes means 8 Mb. You can expand this value if necessary, but make sure that your PHP installation is able to take file uploads of this size.

  • Product picture width. By default, customers can upload image with a maximum width of 64 pixels.

  • Product picture height. By default, customers can upload image with a maximum height of 64 pixels.

  • Generate high-resolution images. The most recent screens with high pixel density (Retina and similar technologies) require high-resolution images. You can enable this feature to make sure your images will display correctly on this kind of screens. It will generate a new file for each of your images, with a resolution twice higher. This will double your number of image files, so use it wisely if you have limited storage space.

Regenerate Thumbnails

You may be dissatisfied with your shop's current thumbnails size. This section makes it possible for you to regenerate them all – or only those for a specific type of content:

  1. Change the image size settings in the table at the top of the "Images" preference page.

  2. Select which content's images should be regenerated.

  3. Indicate whether the previous thumbnails should be kept or not.

  4. Click "Regenerate thumbnails".

Manually-uploaded thumbnails will be erased and replaced by automatically-generated thumbnails.

Last updated