Akeneo Connector for Magento 2 (Community Edition)

103.0.7
Developed by Akeneo
Akeneo PIM compatibility
Enterprise Edition (SaaS) Not supported
Enterprise Edition (PaaS) Not supported
Growth Edition Supported
Community Edition
Magento
compatibility
Editions
Community Edition
Enterprise Edition
Versions
2.3.0
2.3.1
2.3.2
2.3.3
2.3.4
2.3.5
2.4.0
2.4.1
2.4.3
2.4.4
2.4.5
Extension type
Connector
More info
Extension version
103.0.7
Price: Free

Description

The most reliable way to export your catalog to Magento 2

Formerly known as "PIMgento 2", the Akeneo Connector for Magento 2 joins Akeneo's ecosystem to help merchants manage and export their catalog data to Magento 2. This Akeneo Connector version leverages the latest API technology to provide seamless integration between Akeneo PIM and Magento Commerce.

Magento 2

How it works

Magento

Once the architecture of your catalog is completed in Akeneo, and your collections ready for export, you can spread your product content to Magento 2 in just a few steps from the back-end of Magento Commerce. The connector fetches data from Akeneo API and insert it directly in Magento 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:

 

Magento 2

Features

The following Akeneo features can be exported to your Magento 2 webstores thanks to this connector:

  • Categories | Families | Attributes | Options | Products | Product Models

Only Community Edition features of Akeneo are supported with this connector version. To put your hands on the Enterprise Edition of this Akeneo Connector, please click HERE.

Which Akeneo Connector version should I use?

There are 2 versions of the Akeneo Connector for Magento 2.

In addition of the core features of Akeneo Community Edition, the Enterprise Edition of the connector supports additional EE-only features, such as Product Assets or Reference Entities(*).

The Enterprise Edition of the connector also benefits from SLA-backed support by Akeneo teams, as well as evolutions along the year to enhance its performances and its functional scope.

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 Magento 2 does not have an equivalent concept to PIM "Reference Entity", since Akeneo Connector for Magento 2 version 100.2.1, we add a new feature to map PIM Reference Entities at product level in Magento 2: please be sure to read our documentation to understand the Connector configuration possibilities and how this works in Magento 2.

 

Still on Magento 1?

Export your Akeneo catalogs to Magento 1 thanks to the powerful connector developed by our historical partner, Agence Dn'D.

Feature list

Latest update: July 20, 2022

Akeneo PIM data/properties

Product structure: attribute types

  • Identifier More info
    Available
  • Price More info
    Available
  • Text More info
    Available
  • Text area More info
    Available
  • Number More info
    Available
  • Yes-No More info
    Available
  • Date More info
    Available
  • Measurement More info
    Available
  • Simple select More info
    Available
  • Multi select More info
    Available
  • Image More info
    Available
  • File More info
    Available
  • Table More info
    Available
  • Asset collection More info
    Not available
  • Reference entity single link More info
    Not available
  • Reference entity multiple links More info
    Not available

Product structure: attribute properties

  • Localizable attribute (value per locale) More info
    Available
  • Scopable attribute (value per channel) More info
    Available

Product structure: Families

  • Family More info
    Available
  • Family variant More info
    Available

Categories

  • Single category tree More info
    Available
  • Multiple category trees More info
    Available

Products

  • Simple product (with no variation) More info
    Available

Products status

  • Enabled/Disabled More info
    Available

Product model

  • Product with 1 level of variation More info
    Available
  • Product with 2 levels of variation More info
    Available

Attribute type as variation axis

  • Simple select More info
    Available
  • Reference entity single link More info
    Not available
  • Measurement More info
    Available
  • Boolean (Yes-No) More info
    Available
  • Multiple attributes used as a variation axis More info
    Available

Product association

  • Cross sell More info
    Available
  • Upsell More info
    Available
  • Pack More info
    Not available
  • Substitution More info
    Available
  • Custom association More info
    Not available
  • Association with quantities More info
    Available

Association level

  • Association at product level More info
    Available
  • Association at product model level More info
    Available

Assets

Asset structure: attribute type

Asset structure: attribute properties

  • Localizable attribute (value per locale) More info
    Not available
  • Scopable attribute (value per channel) More info
    Not available

Asset level

  • Assets at product level More info
    Not available
  • Assets at product model level More info
    Not available

Reference entities

  • Reference entity properties More info
    Not available

Reference entity structure: attribute type

Reference entity record structure: attribute properties

  • Localizable attribute (value per locale) More info
    Not available
  • Scopable attribute (value per channel) More info
    Not available

Reference entity level

  • Reference entity at product level More info
    Not available
  • Reference entity at product model level More info
    Not available

Published products

Connector/App capabilities

Scope/Channel

  • Capability to manage one eCommerce PIM Channel More info
    Available
  • Capability to manage multiple PIM Channel More info
    Available

Multiple eCommerce organizations/websites

  • Capability to manage multiple eCommerce websites/storefront More info
    Available
  • Capability to manage multiple organizations More info
    Available

Measurement mapping

  • Capability to map the value More info
    Available
  • Capability to map the value and the unit More info
    Available

Attribute mapping

  • Capability to map PIM attribute with eCommerce default attribute More info
    Available
  • Capability to map PIM attribute with eCommerce custom attribute More info
    Available

Family filtering

  • Capability to choose which PIM families to import More info
    Available

Product/Product model filtering

  • Simple filter based on product completness, status, modification date More info
    Available
  • Advanced filter based on attribute values or other product properties More info
    Available

Category filtering

  • Capability to define which category trees to import More info
    Available
  • Capability to define which sub-category trees to import More info
    Not available

Reference entity mapping

  • Capability to import only reference entity record label More info
    Not available
  • Capability to import all the reference entity record data structure with labels and images More info
    Not available

Media/Asset mapping

  • Capability to choose between PIM media attribute (image/file) and/or assets More info
    Available
  • Asset: capability to manage asset media file (media uploaded in the PIM) More info
    Not available
  • Asset: capability to manage asset media link (media from a CDN/DAM) More info
    Not available
  • Asset: capability to manage multiple image sizes More info
    Not available

Data synchronization

Trigger

  • Capability to trigger automatically the data synchronization (with a scheduling system) More info
    Available
  • Capability to trigger the data synchronization manually (on demand) More info
    Available

Synchronization strategy

  • Capability to manage PIM data differential (to import only updated data) More info
    Available
  • Retrying synchronization after failure More info
    Not available

Scalability and performance

  • Capability to manage large PIM data volume/complexity (or known limits) More info
    Available
  • Capability to manage PIM data synchronization time in an optimized way (Time-to-market oriented) More info
    Available

Release notes

Release notes

 

103.0.7 ​​​​

  • Fix Magento Framework dependency in composer.json
  • Fix advanced filter error when left empty
  • Improve URL generation requests for product job

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
  • Fix missing "$edition" variable in `Job/Product.php`

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.1.0

  • 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
  • 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 
  • Fix data patch to correctly encrypt API Client secret when upgrading from previous version

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

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.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 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)

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)

101.4.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

101.3.6

  • Optimize image import by storing result from API calls
  • 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

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

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
  • Fix image attribute re-download check on wrong file path

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

101.2.0

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 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 metric option import when no option is found

101.1.0

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 documentation link in the connector admin configuration page
  • Fix metric attribute unit missing test case

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 check to following:
- 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.4.16

  • Fix file import with uppercase attribute codes
  • Fix auto_increment generation compliance with MYSQL 8

100.4.15

  • Fix image import with uppercase attribute codes

100.4.14

  • Fix product model temporary table data insertion when using multiple channels

100.4.13

  • Fix command constructor inverted comments causing compilation issue

100.4.12

  • 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.4.11

  • Fix website mapping attribute code comparison to lowercase
  • Fix configurable mapping attribute code comparison to lowercase

100.4.10

  • Add configuration check for empty mapping
  • Fix category url_path generation
  • Fix category and family source model return when API credentials are not configured
  • Fix advanced filter issue with family filter variable

100.4.9

  • 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.4.8

  • Fix strict type for Akeneo PHP client pagination variable
  • Fix product count during product model job
  • Optimize product association deletion request

100.4.7

  • 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 websites

100.4.6

  • 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

100.4.5

  • 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.4.4

  • 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.4.3

  • Fix attribute position inside attribute groups being set to 0 during attribute import job

100.4.2

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 category URL request missing "parent_id" select

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 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.6

  • Add check to prevent the creation of attributes and options with empty admin label
  • Fix product association deletion with differential product import

100.2.5

  • 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.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 website mapping from select or multiselect attribute in Akeneo (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

Documentation

Akeneo Connector for Magento 2 Documentation

For any question remaining, have a look at our Help Center to go through the installation process, and a handful of tips to configure the settings of your connector properly.

Help Center