Images

Images can be added to a product using the Images field (Figure 1.1).

Figure 1.1 Adding images

To add an image to a product:

  • Hover over the red plus and select either the upload or the open buttons
  • Select the image(s) you want to add (the product number is automatically added to the search field)
  • Save

Once an image has been added to a product, it can be removed again by hovering over the image and clicking the red x, then saving.

An image can be set as the Default image by hovering over it and clicking the star icon. The default image is typically the first image shown in frontend in product lists and on product details pages. Default images are inherited to any language versions and variants on the product, unless another default image is explicitly set on them.

In more advanced inheritance scenarios you can use image patterns or image categories to define the desired behaviour.

Image patterns – or alternative images – are a way for you to automatically match images in a folder with products in PIM. You may know this feature from Dynamicweb Ecommerce as well. This is done by defining a pattern – e.g. /{ProductNumber_Small.jpg} – and a folder in the PIM Warehouse settings (Figure 2.1).

Figure 2.1 Using Image Patterns in PIM

Image patterns are well-suited to scenarios where images are retrieved from an external source using a predictable pattern for generating names.

You can create a pattern based on the following product fields:

Field

Example

Comment

ProductID

{ProductID}.jpg

 

ProductNumber

{ProductNumber}.jpg

 

ProductName

{ProductName}.jpg

 

ProductManufacturer

{ProductManufacturer}.jpg

 

VariantID

{VariantID}.jpg

 

VariantComboName

{VariantComboName}.jpg

 

VariantOptionLevel

{VariantOptionLevel1}.jpg

Retrieves the name of the variant option added to the product.

If you e.g have colors as 1. level variants (Orange, Green, Blue) they are OptionLevel1.

If you also have sizes as variants (Large, Medium, Small, they are OptionLevel2.

You can combine these fields in any way you’d like, e.g. {ProductNumber}_{ProductManufacturer}.jpg, {ProductNumber}_{VariantComboName}.jpg, or {ProductID}_{ProductName}.jpg, and image patterns support using the wildcard characters ‘?’ and ‘*’.

If more than one image matches the pattern, the first one in alphabetical order will be used.

Please note: In versions prior to 9.6, the Images field must be set to across all variants and across all languages in your field settings.

Image categories are an advanced feature which allows you to both group images, and control how they are inherited across languages and variants. Once an image category is created, an addition images-field appears in the product image section (Figure 3.2). Images added here will follow the inheritance rules specified on the image category.

Figure 3.2 Image Categories have their own images field

To create an image category:

  1. Go to Settings > PIM > Image categories
  2. Click New image category in the toolbar and configure the category:
    1. Name it
    2. Select an inheritance type
    3. Select an icon
  3. Save

There are three inheritance types:

  • None means images with this tag are not inherited from main products to variants
  • Fallback means that images are inherited from the main product to variants if no images are added to the category on the variant
  • Merge means that images are inherited from the main product to variants and merged with images added specifically to the category on the variant

Images can be moved from one image category to another by hovering over the image, clicking the Assign to category button, and selecting another image category.