Connector overview
Akeneo Connector for Adobe Commerce is a module for Adobe Commerce. The connector is therefore installed on Adobe Commerce side and communicates with Akeneo PIM via its API.
The connector is an unidirectional system: it imports PIM data to Adobe Commerce. No Adobe Commerce (Magento) data is sent back to the PIM.

The PIM is considered as the master tool for product data, it should not be handled in Adobe Commerce.
Growth Edition Compatibility
The Akeneo Connector for Adobe Commerce is compatible with our Akeneo PIM Growth Edition. As you know some features managed by the Akeneo Connector for Adobe Commerce are not included in the Growth Edition:
- Reference entities
- Asset manager
- User Rights
We will do our best to deactivate the errors generated in the logs, due to API calls related to those features, but be sure that your full/differential import will be successful.
Process overview
Akeneo Connector for Adobe Commerce is composed by 5 main jobs (5 main processes):
- Category
- Family
- Attribute
- Option
- Product
The Product Model and the Family Variant import processes has been removed since the 101.0.0 version of the Akeneo Connector for Adobe Commerce, and are handled by the Product job
Each job can be triggered manually or automatically on its own.
Each job is responsible for importing PIM architecture and data into Adobe Commerce. The jobs order above should be observed to build your catalog properly. You could skip steps, but please be careful if you do. For example, if you want to import attribute options and you have created new attributes in your PIM, you will first need to import attributes or it will result in an error. Please check your data before importing it!
Technical information: Akeneo Connector for Adobe Commerce inserts all PIM data into a temporary table. Then, data is manipulated (mapping,...) within this temporary table in SQL. Finally, the modified content is directly inserted into SQL in Adobe Commerce tables.
Even if raw SQL insertion is not the way you usually import data into a system, it is still faster than anything else, especially with the volume of data within a full Akeneo catalog. This results in a significant time saving for your imports.
As Akeneo Connector for Adobe Commerce is using SQL insertion, it will not trigger any of the events related to the entities imported. For example, plugins or observers located at product save will not be triggered during the import process.
You will find below the technical details for each process:
Category import process
- Create a temporary table
- Insert data into the temporary table
- Match the PIM code with the entity
- Create a URL key
- Exclude category trees from connector configuration
- Create a position
- Create some category entities
- Set a value for the attribute
- Count of child categories
- Update URL keys
- Drop the temporary table
- Clean the cache
Family import process
- Create temporary table
- Insert data into the temporary table
- Match the PIM code with the entity
- Create some families
- Create family attribute relations
- Init default groups
- Drop the temporary table
- Clean the cache
Attribute import process
- Create a temporary table
- Insert data into the temporary table
- Match the PIM code with the entity
- Match attribute types
- Match the family
- Add some attributes
- Drop the temporary table
- Clean the cache
Option import process
- Create temporary table
- Insert data into the temporary table
- Match the PIM code with the entity
- Insert options
- Insert options label
- Drop the temporary table
- Clean the cache
Product Model import process
The Product Model import process has been removed since the 101.0.0 version of the Akeneo Connector for Adobe Commerce, and is handled by the Product job
- Create a temporary table
- Create temporary reference attribute options table
- Create temporary reference entity records table
- Insert data into the temporary table
- Remove columns from product model table
- Add new columns to product model table
- Insert product models data into product model table
In a Growth Edition use context, step 3 will generate a red warning in the log console due to a non-relevant API end-point call. We will do our best to change that behavior as soon as possible. However, we guarantee you that even with this error, your full/differential import process will be successful.
Family Variant import process
The Family Variant import process has been removed since the 101.0.0 version of the Akeneo Connector for Adobe Commerce, and is handled by the Product job
- Create a temporary table
- Insert data into the temporary table
- Update axis column in the product model table
- Update product model data from variants data
- Clean the cache
Product import process
Since the 100.5.4 version of the Akeneo Connector for Adobe Commerce (the 100.4.6 version for the the Akeneo Connector for Adobe Commerce Community Edition), the product import process is importing the products family after family.
Since the 101.0.0 version of the Akeneo Connector for Adobe Commerce, the product import process is importing both the products and the product models family after family.
- Create a temporary table
- Create temporary reference attribute options table
- Create temporary reference entity records table
- Insert data into the temporary table
- Product Model Import
- Family Variant Import
- Add product required data
- Create configurable products
- Create Options for Variant Metrics Attributes
- Match the PIM code with the entity
- Update the family
- Update column values for options
- Create product entities
- Import file attributes
- Import asset file attribute
- Set values to attributes
- Update configurable products relation
- Update simple products relation
- Set products to websites
- Set products to categories
- Init stock
- Update related, up-sell and cross-sell products
- Set URL rewrites
- Import image attributes
- Import asset attributes
- Drop the temporary table
- Clean the media folder
- Clean the cache
In a Growth Edition use context, steps 3 & 25 will generate a red warning in the log console due to a non-relevant API end-point call. We will do our best to change that behavior as soon as possible. However, we guarantee you that even with this error, your full/differential import process will be successful.