What PIM data are imported into Magento 2?

#Attribute types

Akeneo Connector for Magento 2 imports all these PIM attribute types:

PIM attribute type Magento 2 attribute type
Text Text field
Text area Text area
Date Date (1)
Number Text field
Simple select Drop down (2)
Multiple select Multiple select (2)
Yes/No Drop down (3)
Measurement (aka. metric) Text field or select (4)
Image Media image
File Text field (5)
Asset collection Media image (6)
Identifier Text field
Table attribute Text area (7)

(1) note: the default time will be set at 12AM.

(2) The connector imports all attribute options with their translations. Please note that options without a label in the language of the Magento 2 admin store won't be imported.

(3) As boolean attributes do not exist in Magento 2, the connector converts those as simple select Yes/No attributes.

(4) Since the 100.3.0 version of Akeneo Connector for Magento 2, metric attributes can be imported as text attributes or select attributes if they are used as a variant, with or without the metric unit concatenated (see how to configure products)

(5) Since the 100.4.2 version of Akeneo Connector for Magento 2, file attributes can be retreived from Akeneo PIM inside the Magento 2 media directory. Their path will be inserted in the corresponding text attribute (see how to enable file attribute import)

(6) Only available for Akeneo Connector for Magento 2 Enterprise Edition. As Magento 2 does not support the import of binary files other than images, the connector only import image asset binaries and image asset links (see how to configure images).

(7) Table attribute type doesn't exist by default in the PIM, it is an add-on that has been developed by Flagbit or Webkul company and allows you to add an additional "table" attribute type in your PIM. The connector is therefore compatible with these 2 extensions ! 😃 As Magento 2 does not have a table attribute type, the Connector can import table data into a Magento 2 text area attribute as a JSON structure. Please refer to our connector configuration documentation to know how to manage "table" attribute type.

Some "hot" product data such as updated prices or stock information should not be managed by your PIM but directly by your ERP. A direct connection between your ERP and Magento 2 should therefore be in place.

Please note that, since the 100.3.0 version of the Akeneo Connector for Magento 2, the connector will not import any attribute named price, special_price or cost by default. However you can force it to do it, by mapping your price attribute in your Attribute Mapping configuration. Example: price -> price.

#Attributes

Akeneo Connector for Magento 2 imports all your PIM products attributes.

If you have some localizable attributes (attributes that can have different values per locale): the connector imports the content of these attributes in the different languages of Magento 2 product.

If you have some scopable attributes (attributes that can have different values per channel): depending on your channel configuration, the connector imports the channel content of these attributes for your Magento 2 Website.

As Magento 2 cannot handle attribute codes starting with a number, the connector will reject these attributes during import with a warning message.

In order to be able to synchronize your attributes correctly, please make sure that your attribute codes in Akeneo doesn't start with a number.

Please note that attributes without a label in the language of the Magento 2 admin store won't be imported.

#Categories

Depending on your category configuration, the connector imports all PIM category trees.

Mapping between your PIM and Magento 2:
Akeneo Connector for Magento 2 maps PIM categories with Magento 2 categories.
Because your PIM categories contain only a title while Magento 2 categories enable to have more information (description, image, ...), the connector only imports PIM category title information into Magento 2 category.

Can Akeneo Connector update existing categories in Magento 2? Please check the existing procedure to manage an existing Magento 2 system

#Products, Product models

Depending on your product filter configuration, the connector imports "products" and "product models" of your PIM catalog.

Mapping between your PIM and Magento 2:
The connector maps PIM "products" with Magento 2 Simple products.

Mapping between your PIM and Magento 2:
The connector maps PIM "product model" as such:

PIM Product model with 1 level of variation:

  • PIM product model common part with Magento 2 Configurable product
  • PIM product model variation level 1 part with Magento 2 Simple product

PIM Product model with 2 levels of variation: As Magento 2 only manages only 1 level of variation, for PIM Product model with 2 levels of variation*, Akeneo Connector for Magento 2 concatenates attribute data from common and level 1 layer of product models.

The impact for mapping is as follows:

  • PIM product models common part + variation level 1 are mapped with Magento 2 Configurable product
  • PIM product models variation level 2 is mapped with Magento 2 Simple products

Can Akeneo Connector update existing products in Magento 2? Please check the existing procedure to manage an existing Magento 2 system

#Product associations

Mapping between your PIM and Magento 2:
The connector maps PIM product associations with Magento 2 Related, Up-Sells, and Cross-Sells products.

Since the 101.2.0 version of the Akeneo Connector for Magento 2, you can configure the code of the associations to map with Related, Upsell and Cross-sell products here.

#Product groups

As we have not found an equivalent notion in Magento 2, the connector does not yet import PIM product groups.

#Reference entities [EE] [3.x]

As Magento 2 does not have an equivalent concept to PIM Reference entity, Akeneo Connector for Magento 2 imports Reference entity records at the product level.

Be sure to understand the mapping done by the Connector in Magento 2 products and its associated configuration capability.

#Assets [EE] [4.x]

In the 100.5.0 version of the Akeneo Connector for Magento 2, ONLY images are managed in the asset manager system for the PIM 4.0.

Since the 100.6.0 version of the Akeneo Connector for Magento 2, you can also import videos and files from the asset manager system for the PIM 4.0.

In addition, note that if you are using binaries (images directly uploaded into the PIM) the time transfer can be pretty long due to the download process.