You are here: Configuration > Images


Each product information can contain up to 12 product images shown in the detailed view of the product. Products have zoom images which are also available on the product details page. Smaller product icons show the product in product lists, product boxes and in the shopping cart. All required image types are generated automatically.

Information on image generation and directory structure from OXID eShop 4.5.1 and higher can be found in the Image handling changes tutorial on the OXIDforge page.

Image generation and quality

All settings necessary for image generation and dimensioning for all products are made in the admin panel. Go to Master Settings -> Core Settings, Settings tab. Select Pictures to view the settings. The first setting gives the GDLib software version currently installed on the server for a dynamic image generation. Version 2 is its latest version. Secondly, the automatic icon generation is activated. Leave this settings unchanged.

There is also a small Pictures section in the System tab. Specifying the image quality is important for the image generation. The default setting is 75 providing a good compromise between image quality and file size. With a significant smaller value, images will be highly compressed leading to a smaller file size but worse image quality (blurring and compression artifacts). If the value is higher than 75, the image quality will increase but also will the file size (longer loading times).

The Send e-mails with inline Images option has nothing to do with image generation. With this setting activated, product images will be sent in e-mails. E-mails sent for order confirmation or newsletter will then contain product images. This will lead to larger e-mail sizes which may cause problems when sending and receiving e-mails. By default, e-mails are sent without product images. Product images are subsequently loaded when reading the e-mail by the customer’s e-mail program.

Image sizes

The size of product and category images as well as manufacturer and brand logos depends on the shop design. For this reason, the settings are stored in the active theme in Extensions -> Themes. Select the Settings tab of the “Azure” theme and click Images.

Icon size (width*height)
Icons are the smallest product images and are used in the shopping cart and product boxes (for example: Top of the Shop). Default size: 87 pixels wide and 87 pixels high.

Thumbnail size (width*height)
Thumbnails are preview images and are displayed in product lists such as category views and search results as well as in special promotions (for example: Just arrived). Default size: 185 pixels wide and 150 pixels high.

Category picture size (width*height)
Image displayed in the category view. Default size: 784 pixels wide and 150 pixels high.

Zoom picture size (width*height)
Enlarged view of a product image available on the product details page. Default size: 665 pixels wide and 665 pixels high.

Product picture size (width*height)
Product image shown on the product details page. The size of up to 12 product images can be defined. This allows for product images of different sizes. There is a line for each product image beginning with oxpic and a number. oxpic1 stands for the first product image, oxpic2 for the second and so on. Default size: 380 pixels wide and 340 pixels high.

Note: the option of different image sizes should be used prudently as different-sized product images may lead to a rather unprofessional presentation of the product.

Manufacturer’s/brand logo size
Logo shown in the brand slider on the start page. Default size: 100 pixels wide and 100 pixels high.

Size of a subcategory’s picture (width*height)
Images of the subcategories in the category view. Default size: 168 pixels wide and 100 pixels high.

Category picture size for promotion on startpage (width*height)
Image of the category promoted on start page. Default size: 370 pixels wide and 107 pixels high.