A newer version of this documentation is available: View the Latest Version

Roles

For images and videos Magento provides roles.

  • The standard roles can get extended dynamically

  • Roles can get used to specify where the image or video must get rendered

  • When a new role gets added, Pacemaker supports it by automatically adding new columns that match the role name

  • For each video, there must also be a thumbnail image

  • The video import is an extension of the Pacemaker image import

The following listed roles get provided by the pacemaker. Those can get used to defining which role an imported image or video should have:
Role Description

base

  • The base image is the primary image on the product detail page

  • The image zoom is activated if you upload an image that is a larger image than the image container

  • Depending on the zoom level that you want to achieve, the base image should be two or three times the container’s size

Example sizes:

  • without Zoom:

    • 470 x 470 pixel

  • with Zoom:

    • 1100 x 1100 pixel

small

The small image is used for the product images in listings on category and search results pages and displays the product images needed for sections such as for

  • Up-sells

  • Cross-sells

  • New Products List

Example size:

  • 470 x 470 pixel

thumbnail

Thumbnail images get displayed in

  • Thumbnail gallery

  • Shopping cart

  • In blocks such as Related Items

Example size:

  • 50 x 50 pixels

swatch

A swatch is used to illustrate:

  • color

  • pattern

  • texture

Example size:

  • 50 x 50 pixels