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

#"Website" attribute mapping

Since Akeneo Connector for Magento 2 version 100.2.1, in the connector configuration page, in Products, you can choose how to associate your products to your websites using a select or multiselect attribute:

Connector parameter Magento information
Website Attribute PIM "website association" attribute ID (ex: website_association)

The attribute code given must be a valid Akeneo select or multiselect attribute. The code of its options in Akeneo must match your Magento 2 websites codes. You can find your Magento 2 websites codes in Store > Configuration.

Your products will be assigned to the websites selected in the given attribute. If the value for this attribute is empty for a product, it won't be assigned to any website.

If this configuration is empty, your products will be assigned automatically following your Website Mapping found in Akeneo API Configuration.

#"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

#Metric Attributes

Since the version 100.3.0 of Akeneo Connector for Magento 2 in the connector configuration page, in Products, you can configure the behavior of your Metric attributes :

Connector parameter Akeneo Metric Attribute Used As Variant Concat Metric Unit
Metric Attributes PIM attribute ID Set to "Yes" if the metric attribute is used as a variant Set to "Yes" if you want to concat the metric unit to the value imported in Magento 2

By default, if a Metric attribute is not declared in this configuration, it will be created as a Text attribute in Magento 2 containing the numeric metric value. It won't be usable as a variant.

Setting an Akeneo Metric attribute as variant will make this attribute a Select attribute in Magento 2. Options will be dynamically added during product import and will either contain the metric unit or not depending on the value of the "Concat Metric Unit" field.

Setting the Concat Metric Unit option to "Yes" will work for both metric attributes created as Text attribute and Select attribute.

If you already imported a Metric attribute as a Text attribute in Magento 2, you will not be able to configure it as a variant attribute and change its type to Select attribute. To do so, you will have to delete the previously imported attribute and import it again.

#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 attributes and default values

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

Connector parameter Attribute Type Value
Configurable Attribute code Type from the list (see "Types" below) Value (can be empty)

Since Akeneo Connector for Magento 2 Community Edition version 100.2.5 and Enterprise Edition version 100.2.6, the Type column has been added to this configuration in order to provide better understanding and management of configurable product attributes.

Types:

  • Product Model value: Declare each PIM common attributes you want to be imported in the Magento configurable products. Leave the value field empty.
  • First Variation value: Declare each PIM variation specific attributes you want to be imported in the Magento configurable products. The value of the first variation associated to the product model will be inserted in the corresponding Magento configurable product attribute. Leave the value field empty.
  • Mapping: Declare each PIM common attributes you want to be mapped with another Magento attribute. Fill the value field with the corresponding Magento attribute. Example: Attribute = name_product_model and Value = name
  • SQL Statement: Use a SQL statement in the value field for custom value assignation from Akeneo Connector temporary tables. Example: Attribute = url_key and Value = LOWER(url_key)
  • Default value: Fill the value field to assign a constant default value for a given attribute. Example: Attribute = enabled and Value = 0

If a product model common attribute is not defined in the attribute column, it won't be imported for the configurable product.

Example: Product Model value - Declare PIM common attributes to be imported to configurable products

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

If the "name" attribute is filled in your product model, it will be set to the configurable product.

Example: First Variation value - Import weight from first variation

Connector parameter Attribute Type Value
Configurable PIM "weight" attribute ID (ex: weight) First Variation value Empty

It will import the weight of the first variation associated to your product model in the configurable product in Magento

Example: Mapping - Map a product model common attribute to Magento name attribute

Connector parameter Attribute Type Value
Configurable PIM "product name" attribute ID (ex: product_model_name) Mapping Magento "product name" attribute ID (ex: name)

If a variation specific attribute is already mapped with the Magento "name" attribute in the "Attribute mapping" section, both mappings will be applied respectively.

If you map a variation specific attribute and a product model common attribute to the same attribute in Magento, please make sure that those two attributes are configured the same way in Akeneo for: Value per channel and Value per locale.

Example: Set default value to a Magento configurable product attribute - Disable all configurable products

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

Connector parameter Attribute Type Value
Configurable enabled Default value 0

Example: SQL statement to manipulate configurable product attribute value

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

Connector parameter Attribute Type Value
Configurable PIM "weight" attribute ID (ex: weight) SQL Statement 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