How to configure products?

#"Attribute type" mapping

By default, Akeneo Connector for Magento 2 supports all native PIM attribute types. In addition, you could still map a PIM attribute type and a Magento attribute type in the event of a custom attribute type in your PIM.

Do not map native Akeneo attribute types with native Magento types, as this mapping will automatically be handled by the Connector. This mapping is only necessary for custom Akeneo attribute types.

In the connector configuration page, in Attributes, you can choose how to convert some specific PIM attribute types to Magento attribute types:

Connector parameter PIM Information Magento information
Additional types PIM attribute type ID Magento attribute type

For example, you can manage the Flagbit or Webkul table attribute bundles and retrieve table attribute JSON structure as a Magento 2 text area attribute type.

For Webkul table attribute:

Connector parameter PIM Information Magento information
Additional types pim_catalog_table Text area

For Flagbit table attribute:

Connector parameter PIM Information Magento information
Additional types flagbit_catalog_table Text area

#"Attribute" mapping

In the connector configuration page, in Products, you can choose how to map a PIM attribute with a Magento attribute:

Connector parameter PIM Information Magento information
Attribute mapping PIM attribute ID Magento attribute ID

You don't need to map attributes with the same code in Akeneo and Magento 2, the Connector will automatically transfer the data without mapping.

This mapping only copies the value from an attribute to another. Make sure to map two attributes of the same type.

Example: My Akeneo description attribute doesn't have the same code than the Magento 2 description attribute

If your description attribute in Akeneo is called "description_web", you can map the native Magento 2 "description" attribute with your "description_web" attribute from Akeneo in the mapping as follows:

Connector parameter PIM Information Magento information
Attribute mapping PIM "description" attribute ID (ex: description_web) description

Example: SEO - How to set a product name as a URL?

Set the "Attribute mapping" parameter as follows:

Connector parameter PIM Information Magento information
Attribute mapping PIM "product name" attribute ID (ex: name) url_key

#Default tax class for a Website

In the connector configuration page, in Products, you can choose the default tax class for a specific Magento 2 Website:

Connector parameter Magento information
Default Tax Class None
Taxable Goods
Refund Adjustments
Gift Options
Order Gift Wrapping
Item Gift Wrapping
Printed Gift Card
Reward Points

Custom tax classes created in Magento 2 will automatically appear in this field so you can assign them to your products.

#Configurable product attribute and default values

In the connector configuration page, in Products, you have to define the Magento 2 configurable attributes which you want to import.

Connector parameter Attribute Value
Configurable Attribute code Value (can be empty)

Fill the attribute column with the configurable attribute codes and leave the value column empty to import them to your configurable products.

If an attribute is not set in the attribute column, it won't be imported for the configurable product.

Example: Declare attributes to be imported to configurable products

Connector parameter Attribute Value
Configurable PIM "product name" attribute ID (ex: name) Empty

If the "name" attribute is filled in your product model, it will be set to the configurable product, otherwise the Connector will set the name of the first product associated to it.

Example: Set default value to configurable attributes - Disable all configurable products

Use the value column to force the value for all configurable products for a specific attribute.

Connector parameter Attribute Value
Configurable enabled 0

Example: SQL statement to manipulate configurable product attribute value

You can set an SQL statement in the value column to manipulate a configurable attribute value from the connector import tables. Alias for product model table is "v." and alias for temporary table is "e."

Connector parameter Attribute Value
Configurable PIM "weight" attribute ID (ex: weight) SQL statement (ex: e.weight/1000)

#Regenerate URL rewrites

In the connector configuration page, in Products, you can enable to regenerate URL rewrites for Magento 2 products:

Connector parameter Magento information
Regenerate URL rewrites Yes or No