Akeneo Connector for Adobe Commerce/Magento (Enterprise Edition)

Description
The most reliable way to export your catalog to Adobe Commerce
The Akeneo Connector for Adobe Commerce joins Akeneo's ecosystem to help merchants manage and export their catalog data to their webstores. This Akeneo Connector version leverages the latest API technology to provide seamless integration between Akeneo PIM and Adobe Commerce/Magento. This module is compatible with Adobe Commerce and Magento, but to ease the reading we will only mention Adobe Commerce.
With Akeneo PIM Cartridge for B2C Commerce, feed high-quality and emotionally resonant product information from your PIM to your eCommerce platform, enabling you to improve your customers' shopping experiences, increase conversions, and reduce returns. Set up predefined jobs in B2C Commerce Business Manager to retrieve product information, including attributes, variants, categories, associations, and assets, from Akeneo PIM and map it to existing B2C Commerce taxonomy using a set of custom preferences. Customize the connector to create a personalized experience.

How it works
Once the architecture of your catalog is complete in Akeneo, and your collections are ready for export, you can spread your product content to Adobe Commerce in just a few steps from the Dashboard of Adobe Commerce. The connector fetches data from Akeneo API and insert it directly in Adobe Commerce database. As a result, imports are very fast and don't cause outages of your webstores.
See how it works in details with an end-to-end demonstration of our Akeneo Connector here:

Features
The following Akeneo features can be exported to your Adobe Commerce webstores thanks to this connector:
- Categories | Families | Attributes | Options | Family Variants | Products | Product Models
- Assets (Enterprise Edition exclusive)
- Reference Entities(*) (Enterprise Edition exclusive)
The Enterprise Edition version of this Akeneo Connector also comes with a handful of benefits:
- Corrective maintenance from your usual Akeneo Support contacts
- Evolutions along the year to enhance the performances, the scope and support the latest features of Akeneo PIM Enterprise Edition and Adobe Commerce
- Access to the connector roadmap for full visibility
Features | Community Edition | Enterprise Edition |
---|---|---|
Categories | ||
Families | ||
Attributes | ||
Options | ||
Products | ||
Product Models | ||
Assets | ||
Reference Entities(*) | ||
Benefits | Community Edition | Enterprise Edition |
Documentation | ||
Corrective Maintenance | ||
Evolutive Maintenance | ||
Access to the connector roadmap |
(*) As Adobe Commerce does not have an equivalent concept to PIM "Reference Entity", since Akeneo Connector for Adobe Commerce version 100.2.1, we add a new feature to map PIM Reference Entities at product level in the ecommerce: please be sure to read our documentation to understand the Connector configuration possibilities and how this works in Adobe Commerce.
Contact and Support
Get in touch with the Akeneo team to know more about the perks and the support model of Akeneo Connector for Adobe Commerce (Enterprise Edition).
- Tel. (France): +33 (0)2 55 59 00 00
- Tel. (Germany): +49 211 2339 6655
- Tel. (North America): +1 (833) PIM-4ALL
- E-Mail: magento@akeneo.com
Feature list
Akeneo PIM data/properties
Product structure: attribute types
-
Identifier More infoAvailable
-
UUID and SKUs optional More infoNot available
-
Price More infoAvailable
-
Text More infoAvailable
-
Text area More infoAvailable
-
Number More infoAvailable
-
Yes-No More infoAvailable
-
Date More infoAvailable
-
Measurement More infoAvailable
-
Simple select More infoAvailable
-
Multi select More infoAvailable
-
Image More infoAvailable
-
File More infoAvailable
-
Table More infoAvailable
-
Asset collection More infoAvailable
-
Reference entity single link More infoAvailable
-
Reference entity multiple links More infoAvailable
Product structure: attribute properties
Categories
Products
-
Simple product (with no variation) More infoAvailable
Products status
-
Enabled/Disabled More infoAvailable
Product model
Attribute type as variation axis
Product association
Association level
Assets
Asset structure: attribute type
Asset structure: attribute properties
Asset level
Reference entities
-
Reference entity properties More infoAvailable
Reference entity structure: attribute type
Reference entity record structure: attribute properties
Reference entity level
Published products
-
Published product More infoNot available
Connector/App capabilities
Scope/Channel
Multiple eCommerce organizations/websites
Measurement mapping
Attribute mapping
Family filtering
-
Capability to choose which PIM families to import More infoAvailable
Product/Product model filtering
Category filtering
Reference entity mapping
Media/Asset mapping
-
Capability to choose between PIM media attribute (image/file) and/or assets More infoAvailable
-
Asset: capability to manage asset media file (media uploaded in the PIM) More infoAvailable
-
Asset: capability to manage asset media link (media from a CDN/DAM) More infoAvailable
-
Asset: capability to manage multiple image sizes More infoAvailable
Data synchronization
Trigger
Synchronization strategy
Release notes
Release notes
103.3.1
- Fix product job import for a family with only the SKU attribute inside it
- Fix localizable asset collection image role assignation not applied on every stores
103.3.0
- Add localizable and scopable image attribute import (documentation)
- Add job grid automatic refresh in order to provide real time progress of jobs (documentation)
- Add attribute option mapping when a select / multi-select attribute is mapped with an existing attribute on Adobe (documentation)
- Improve extension coding standards
- Fix column size improvement to manage uppercase attribute codes
- Manage empty attribute values returned by Akeneo API by creating missing columns inside the product temporary table
- Fix asset retro-compatibility patch from version 103.1.0 to manage empty asset configurations
Warning: change of behavior on empty values
103.2.0
- Improve column sizes per attribute type inside product temporary table in order to reduce the MYSQL table volume
- Add batch for large inserts during asset association
- Fix thumbnail association during asset import
- Fix image type association to first asset in the event of multiple assets assigned to a product
103.1.4
- Fix URL rewrite generation when multiple url keys are duplicated
103.1.3
- Fix wrong thumbnail on products when using asset import
103.1.2
- Fix asset import error with PHP 7.4
- Fix Magento Framework dependency in composer.json
- Fix advanced filter error when left empty
- Improve URL generation requests for product job
103.1.1
-
Fix reference entity record JSON import with record code "0"
103.1.0
- Fix manually added product videos being deleted by the image attribute import
- Rewamp asset collection attribute image import: Documentation
- Add the possibility to map assets to specific Magento image types
- Add the possibility to import multiple asset image attributes from the same asset
- Add the possibility to map different asset collection attributes to configurable and simple / grouped / virtual products
- Add a configuration to hide image assets from the product gallery
- Separate JSON import configuration from asset image import in the product gallery
- Improve asset image import performances
Warning : When upgrading your connector to this version, make sure to double check your asset collection image import configuration if applicable.
103.0.6
- Fix manually added product videos being deleted by the image attribute import
103.0.5
- Fix product relation deletion for simple products when using differential import
- Fix default status mode when scheduled changes are used for products
- Fix reference entity option import with the same label when using option code as "Admin label"
- Add new dispatch events at error and success in the job executor
103.0.4
- Fix "setRelated" temporary table name to unique value
- Fix product model variant change in `catalog_product_super_attribute` table
- Fix `Too few arguments to function Laminas\Diactoros\ResponseFactory::__construct()` issue by adding `nyholm/psr7` dependency
103.0.3
-
Fix simple product association with configurable product when a variation from a two-level family variant is imported without the product model
103.0.2
- Fix "setRelated" temporary table name to MYSQL maximum table name length
- Fix "price", "special_price" and "cost" attribute import by setting default value for every temporary table columns to NULL
103.0.1
- Improve "setRelated" (Associations) and "setWebsites" (Website Attribute) steps performance for Product job
- Fix job status not displaying in mail report
- Fix metric unit being displayed twice if the same attribute is configured in "Metric Attributes"
103.0.0
- Add compatibility for Magento 2.4.4 and PHP 8.1: Documentation
- Remove deprecated Akeneo API client EE
- Bump Akeneo API client to version 9
- Replace Guzzle HTTP client by Symfony HTTP Client
- Fix function usage for PHP 8
- Update extension PHP compatibility to 7.4 and 8.1
- Fix "special_price" and "cost" attribute being set to 0 when empty on MariaDB
102.6.1
- Fix "Product Status Mode" not displaying if Akeneo version is different from "Serenity" or "Growth" edition
- Fix "Since last successful import" mode not working on first product job without successful date
- Fix relations from "catalog_product_relation" table for grouped and bundle products being deleted during the product job
- Fix job status to "Error" if missing or wrong API credentials are set in the connector configuration
102.6.0
- Add automatic 301 redirect when the url_key of a product is updated Documentation
- Add compatibility with reference entity attribute and measurement attribute inside table attribute Documentation
- Fix data patch to correctly encrypt API Client secret when upgrading from previous version
- Fix Video asset import when no asset are configured for a specific scope using scopable asset collection video attribute
102.5.1
- Fix every family being fetched while using IN family search with advanced filter mode
102.5.0
- Add product status mode "Attribute mapping" in order to map a Yes/No attribute to the status attribute - Documentation
- Use "is_root" Akeneo API parameter for category endpoint in order to generate options for the category import configuration in the admin page
102.4.0
-
Update temporary tables default column type from "text" to "mediumtext" in order to manage maximum field size for "textfield" attributes in Magento
-
Fix "IN" family filter for advanced product filter mode importing every family instead of only one
102.3.2
- Fix product job status still being "Processing" if the last family imported have no product to update
102.3.1
-
Improve option job performance by optimizing existing option mapping requests and process
102.3.0
- Fix "is_null()" and "empty()" usage
- Fix "akeneo_connector:import" command help usage
- Fix product job status to error and don't update import success date when one of the families in the job fails
- Fix localizable and scopable attributes being created with wrong scope
- Update success messages when scheduling a job from the admin grid
- Update connector tables definition to "db_schema.xml"
- Update setup scripts to patch format
- Fix message column format from "akeneo_connector_import_log_step" table to text in order to see full log messages
- Remove filters on the admin job grid
102.2.1
- Fix website mapping with uppercase attribute code in Akeneo
- Fix reference entity import for product models causing warning
102.2.0
-
Add new "Status mode" in order to assign simple product status from a completeness level (Documentation)
-
Add job logs cleaning task (Documentation)
-
Add email reporting for job execution (Documentation)
-
Use PHP short syntax and escape translations in templates
-
Fix Magento 2 serializer usage to encode and decode JSON
102.1.5
-
Remove "NOT IN" family filter in API call during product job when using Standard filter
102.1.4
- Add compatibility with the new Akeneo table attribute type (Documentation)
102.1.3
- Fix reference entity record data fetching during each family import in product job
102.1.2
- Fix URL rewrite generation when mapping a scopable attribute to the url_key attribute
102.1.1
- Fix Product job execution per family not continuing after a job error occurs in a specific family
102.1.0
- Add "Since last successful import" filter for product job (Documentation)
- Add product type attribute mapping for virtual products (Documentation)
- Add Akeneo Connector CRON group (Documentation)
- Fix error during product job when a non asset collection attribute is filled in asset configurations
- Fix processing label display in log grid
- Update API Secret configuration to obscure type
- Update all connector configuration scopes to "Global"
102.0.2
- Fix website mapping not working when product job is scheduled and if "Set attribute option code as Admin label for attribute options" configuration is set to "Yes"
102.0.1
- Fix content staging scheduled update for a product, or a category without end date being updated wrongfully when "Does Akeneo data override content staging" configuration is set to "No"
102.0.0
- Add new asynchronous import system: (Documentation)
- Remove old console import in "System > Akeneo Connector > Import"
- Add new "akeneo_connector_job" table to manage job entity
- Add new cron task "akeneo_connector_launch_scheduled_job" to run jobs in background
- Add new job grid under "System > Akeneo Connector > Jobs" in order to manually schedule and run jobs - Prevent concurrent job trigger if a job is already scheduled or running
Warning: In order to use the new import system, please make sure that Magento 2 CRON are correctly running
(Documentation)
101.8.2
- Fix issue on temporary table indexes when a column is missing
101.8.1
- Add index to "code" column in every job temporary tables
- Add index to "identifier" column in product job temporary table
- Add index to "attribute" column in option job temporary table
101.8.0
- Add configurations to choose which cache to flush after each job (Documentation)
- Add configurations to choose which index to refresh after each job (Documentation)
- Add option to import video asset data as JSON (Documentation)
101.7.0
- Add content staging support for category import (Documentation)
101.6.1
- Fix existing attribute option mapping from admin label with Akeneo attribute options
101.6.0
- Add configuration to set Akeneo attribute option code as Admin label for options in Magento 2 (Documentation)
- Add "Since last X hours" product filter in order to filter Akeneo product updated date in hours (Documentation)
- Add option to import file asset data as JSON (Documentation)
101.5.0
- Update URL rewrite generation for products in order to either correctly assign by stores the values of an attribute from Akeneo or assign the SKU as default URL key
- Update asset image extension whitelist in order to add uppercase extensions: "PNG, JPEG, JPG"
101.4.0
- Add an option in the connector configuration panel to not download the image files anymore and only import image asset data as JSON in “Akeneo Asset Manager Image Attributes” configuration - check online help
101.3.6
- Optimize image import by storing result from API calls
- Optimize reference entity import by creating and dropping table at the beginning and at the end of the entire product job
- Fix Block/Adminhtml/System/Config/Form/Field/FileAsset.php class name case
- Fix error message on metric option creation when no value was found for an entire locale
- Fix export PDF generation for image configuration and strpos strict testing
- Update URL rewrite warning message color
101.3.5
- Add export Akeneo Connector configuration button in the admin configuration page
- Add advanced logging mode in configuration (Documentation)
- Add Akeneo Growth Edition in Akeneo Edition selector configuration (Documentation)
- Fix completeness in advanced filter mode for product model not being applied
101.3.4
- Fix attribute requests condition on "entity_type_id" in order to prevent MYSQL errors during option import
101.3.3
- Add compatibility for variation product parent change and variation product becoming a simple product in Akeneo
- Fix connector compatibility with Akeneo 3.1
- Fix category tree import with numeric code
- Fix category URL rewrite generation on useless stores causing "-X" added to category URLs
- Fix download of file attribute failing since last client upgrade
101.3.2
- Change job error status to success when no products are imported for a family
- Update information warning messages color from red to orange
- Optimize reference entity import by adding locale filter to API call and update warning message for duplicate option label
- Add "Asset Attribute Used As Image" field in the "Akeneo Asset Manager Image Attributes" configuration in order to choose which attribute from the Akeneo Asset Family has to be imported in the Mageto 2 product gallery (Documentation)
101.3.1
- Remove automatic scope filter that was added when using the product and product model Advanced Filter
- Add Family code in Magento 2 attribute set label to prevent SQL insertion error when multiple family have the same label
101.3.0
- Upgrade Akeneo API PHP Client to version 6.0
Warning : After updating Akeneo Connector for Magento 2 to this version, make sure to update your composer dependencies
- Add Akeneo version 5.0 or greater in version selector
- Add Asset Collection image attribute configuration to be used as swatch image (Documentation)
- Optimize Reference Entity media attribute import when it already exists
101.2.0
- Add grouped product management with quantity association (check online doc)
- Add product association mapping definition in the connector (check online doc)
101.1.2
- Fix image attribute import to fill the catalog_product_entity_media_gallery_value table
101.1.1
- Add attribute filtering by type from API in the admin configuration page and for reference entities fetching for Akeneo version 4.0.62 or greater and Akeneo Serenity
- Add attribute updated date filter in connector configuration for Akeneo version 4.0.62 or greater and Akeneo Serenity (Documentation)
- Add attribute filter by code in connector configuration for Akeneo version 4.0.62 or greater and Akeneo Serenity (Documentation)
- Fix category tree filtering when no categories are excluded for Akeneo version 4.0.62 or greater and Akeneo Serenity
- Fix attribute job when no attribute is found with correct label
- Fix reference entity import when no reference entity attribute code is found in the temporary table
- Fix metric option import when no option is found
101.1.0
- Add new Akeneo Edition selector configuration (Documentation)
Warning: After updating Akeneo Connector for Magento 2 to this version, make sure to configure the correct Akeneo Edition in your connector configuration
- Add category tree filtering from API for Akeneo PIM version 4.0.62 or greater and Akeneo PIM Serenity
- Add family updated date filter in connector configuration for Akeneo PIM version 4.0.62 or greater and Akeneo PIM Serenity (Documentation)
101.0.2
- Add prefix and suffix management for media link asset images, files and videos (Documentation for asset images, files and videos)
- Add documentation link in the connector admin configuration page
- Fix metric attribute unit missing test case
101.0.1
- Fix unhandled error message during reference entity attribute option creation when the label is missing
- Fix option label already exist notice for reference entity attributes displaying wrongly and blocking the import of one option
101.0.0
- Add product model import family by family: (Documentation)
- Remove "Product Model" and "Family Variant" jobs (Documentation)
- Remove deprecated table "akeneo_connector_product_models" (Documentation)
- Remove deprecated configuration "Product Model Batch Size" and "Product Model Update Length" (Documentation)
- Merge "Product Model" and "Family Variant" job into "Product" job (Documentation)
- Add specific "Product Model Completeness Filter" configuration (Documentation)
- Add specific "Product Model Advanced Filter" configuration (Documentation)
- Apply "Standard Product Filters" to product models (Documentation)
- Add automatic mapping of product model specific attributes in the "Configurable" configuration of the connector (Documentation)
- Remove type "Product Model Value" from "Configurable" configuration (Documentation)
Warning: After updating Akeneo Connector for Magento 2 to this version, make sure to:
- Remove the previously declared CRON jobs for old "Product Model" and "Family Variant" jobs
- Audit and rework your previous customizations on the "Product Model", "Family Variant" and "Product" jobs, as this new version contains compatibility break changes
100.6.2
- Fix file import with uppercase attribute codes
- Fix auto_increment generation compliance with MYSQL 8
100.6.1
- Fix image import with uppercase attribute codes
- Remove unused variable in attribute import job
100.6.0
- Add asset manager compatibility for asset Video and asset Files import
- Fix product model temporary table data insertion when using multiple channels
100.5.11
- Add credentials check before command line import jobs
- Add pagination to API calls in the admin configuration page
- Add security to prevent import of attributes starting with numbers (Documentation)
- Add column filtering for job status in the admin connector log grid - Fix custom options deletion after each product import
100.5.10
- Fix asset image import attribute code comparison to lowercase
100.5.9
- Fix website mapping attribute code comparison to lowercase
- Fix configurable mapping attribute code comparison to lowercase
100.5.8
- Add configuration check for empty mapping
- Fix category url_path generation
- Fix category and family source model return when API credentials are not configured
100.5.7
- Fix product filters not being reseted after each family during command line execution
- Fix create table function causing some products and product models not being imported in multi-website environment
- Fix misleading warning label during image import
- Fix Akeneo API connection being initialized in construct on the admin configuration page of the connector
100.5.6
- Fix strict type for Akeneo PHP client pagination variable
- Fix product count during product model job
- Fix reference entity data unserialize issue when empty
- Optimize product association deletion request
100.5.5
- Fix reference entity attribute option creation when the same reference entity is linked to multiple attributes
- Fix product default status behavior conflict with Magento 2 Enterprise content staging feature
- Optimize category association deletion request during product import
- Skip product URL rewrite generation for non-associated websitesAkeneo Connector for Magento 2 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 Magento 2 tables.
100.5.4
- Add product import job batching family after family (Documentation)
- Optimize product model column number in a temporary table by adding a filter for API request on mapped channels and available locales
- Fix reference entity attribute option assignment on products after version 100.5.2 separator change
100.5.3
- Add support for the import of scopable and localizable values of assets inside the Asset Manager 4.0
- Remove URL key generation for non-visible products
- Fix metric option creation when a value is set on a product model specific attribute
- Fix metric value set to "0" when empty on Akeneo
- Fix website association not deleted when website attribute value is empty for a product
- Optimize deletion of akeneo_connector_product_model columns during product model import job
100.5.2
- Global classes reformatting including: change private scope of variables and functions, remove AbstractHelper usage, fix usage of Akeneo\Connector\Job\Import class and change job types to object
Warning: After updating connector to this version, make sure to recompile your code, flush Magento 2 cache and check your custom developments
- Add support for Magento 2 Enterprise Content Staging feature (Documentation)
- Fix Magento 2 Enterprise is_returnable default value for products
- Fix multi-select attribute options assignation causing multiple options with similar code to be selected
- Fix attribute option code separator in akeneo_connector_entities table
100.5.1
- Fix attribute position inside attribute groups being set to 0 during attribute import job
100.5.0
- Add Image asset compatibility for Akeneo PIM V.4.0 asset manager (Documentation).
- Video and file assets are not yet managed.
Warning: After updating connector to this version, make sure that your dependencies are up-to-date as the Akeneo PHP Client has been updated to version 5.X
100.4.3
- Fix reference entities JSON import with configurable products
100.4.2
- Add support for file attributes import (Documentation)
- Add feature to apply default status to new products (Documentation)
100.4.0
- Add automatic mapping for existing attributes, attribute options and products in Magento (Please read carefully our documentation)
- Add entities check in connector entities table before import
100.3.4
- Fix product URL rewrite generation to prevent duplicate entry errors
- Fix product URL generation for configurable product in case of mapping with url_key
100.3.3
- Fix error on price attribute import
- Fix category attribute set getter to prevent mixed id in case of data migration
- Fix metric import when metric attribute code contains uppercase characters
- Add product model batch size and request size to prevent MYSQL errors. To know more, please consult our Documentation.
100.3.2
- Fix Object Manager usage
- Fix files name length for reference entity attributes
100.3.1
- Fix product image and asset name that should not exceed 90 characters since Magento 2.3.3
Warning : After updating connector to this version, all image names will be renamed. To know more, please consult our Documentation.
- Remove unused "file" column on log grid
- Move API client call from construct
- Fix category URL issue adding -1, -2 to url-key when category had same name but not same parent category
100.3.0
- Remove Akeneo attribute group import from connector (Documentation)
- Remove automatic mapping for attributes "price", "special_price" and "cost" (Documentation)
- Add metric as product variant and unit concatenation feature (Documentation)
- Update wording for configurable product attribute mapping
100.2.7
- Add check to prevent the creation of attributes and options with empty admin labels
- Fix product association deletion with differential product import
- Add asset file verification when its missing in Akeneo
100.2.6
- Improve configurable attributes feature with specific types (Documentation)
Warning : After updating connector to this version, please check the Configurable
configuration under the Products
section in the Akeneo Connector configuration and update the Type
column of your mapping with the appropriate value if necessary.
100.2.5
-
Fix option import with reference entity feature
100.2.4
- Fix import command description
- Convert uppercase attribute mapping to lowercase
- Set import job response after step finish events
100.2.3
- Fix identifier column type in temporary product import table
- Fix missing where statement on delete in website association feature
- Fix product website request if attribute is not filled in Akeneo
- Fix duplicate node in config.xml file
- Add check on family label to prevent import error on duplicate labels in Akeneo
100.2.2
- Fix issue when importing associations
- Improve attribute option import
100.2.1
- Add reference entity single/multiple link attribute import and reference entity records data import (Documentation)
- Upgrade Akeneo PHP API client to version 4 in order to handle reference entities endpoints
- Add website mapping from select or multiselect attribute in Akeneo (Documentation)
- Manage simultaneous image attribute and asset collection attribute import (Documentation)
- Use native Magento serializer
- Fix proxy class injection in command construct
- Fix association import when result is empty
- Fix url_key mapping and generation
100.1.1
- Fix attribute mapping key
100.1.0
- Initial release