How to import my PIM Reference Entities?

#What "Reference entities" are we talking about exactly?!

Akeneo PIM Enterprise Edition has a feature called Reference Entities (Please consult our documentation "What is a reference entity?").

Akeneo Connector for Magento 2 Enterprise Edition (since version 100.2.1) can manage Reference Entities data from these attribute types:

  • Reference entity single link
  • Reference entity multiple links

Akeneo Connector for Magento 2 Community Edition version doesn't manage reference entities (because 'reference entities' are a specific PIM Entreprise Edition feature).

#How can I import "Reference entities" into Magento 2?

As Magento 2 does not have an equivalent concept to PIM "reference entity", we decided to map these reference entities at the product level.

In the connector configuration page, under Attributes, you can retrieve reference entities with the following parameters:

Two modes are available to import each reference entity single or multiple links attribute:

  • No: The connector imports a simple/multi select attribute at product level with localized labels.
  • Yes: The connector imports a simple/multi-select attribute at product level with localized labels AND imports a text area attribute that contain all data from reference entities linked to the product (in JSON format).
Connector parameter Magento information
Get reference entities attributes Yes or No(default)

This mapping operation therefore duplicates the data of PIM reference entities at the product level in Magento 2.
Please ensure that the amount of data generated does not slow down the synchronization of your data too much.