How to import my PIM images?

#What "images" are we talking about exactly!?

Akeneo PIM Enterprise Edition has 2 ways to store images for your products.

Either with several Image attributes or with the Asset collection attribute that points to one or more images from the Assets management feature (Akeneo PIM Enterprise Edition only).

  • Akeneo Connector for Magento 2 Community Edition can retrieve images from Image attributes only.
  • Akeneo Connector for Magento 2 Enterprise Edition can retrieve images from either Image attributes OR from Asset collection attributes.
    • You can use multiple image attributes, multiple asset collection attributes, but not both image attribute and asset attribute at the same time

#How can I retrieve images from "Image" attributes?

In the connector configuration page, in Products, you can retrieve images from PIM Image attributes with the following parameters:

First, select Yes if you want to import images:

Connector parameter Magento information
Import media file Yes or No

Then, list all your PIM Ìmage attributes:

Connector parameter PIM information
PIM Images Attribute PIM Image attribute ID

Finally, define the mapping between PIM Image attribute and Magento Image types:

Connector parameter Magento information PIM information
Product Images Mapping image(image) PIM Image attribute ID
small_image(small_image)
thumbnail(thumbnail)
swatch_image(swatch_image)

#How can I retrieve images from "Asset collection" attributes?

This feature is only available for Akeneo Connector for Magento 2 Enterprise Edition.

If you don't use the PIM Image attribute but the Asset collection attribute for your images, in the connector configuration page, in Products, select Yes to retrieve images from Asset instead of Image attributes:

Connector parameter Magento information
Import Asset Files Yes or No

As Magento 2 can't handle binary videos or files (like PDF), please note that the current version of Akeneo Connector for Magento 2 only imports images from PIM assets (no video, no file).

#How can I define the "base" image?

#With Image attributes

Akeneo Connector for Magento 2 takes the first created "Image attribute" to define which image will be the "base" image in Magento 2 for the product.

#With Assets collection attributes

Akeneo Connector for Magento 2 takes the first image of the first created "asset collection attribute" to define which image will be the "base" image in Magento 2 for your product.

In Akeneo PIM, please be aware you could change the image order for an asset collection attribute with a simple drag & drop action.