Most frequently asked questions about the Connector

Summary

Performance

How long will it take to synchronize 1000 products from Akeneo PIM to Adobe Commerce (Full Load)?

It is difficult to give a precise time for this question because it depends on many parameters (catalog properties (i.e how many attributes per product? How many localizable attributes? How many pictures?...), server hardware power, server configuration, network capacity,...etc...).

As Akeneo Connector for Adobe Commerce is based on the same architecture as Pimgento 2 API, you could read this article from DnD company to get an idea of the Connector's performance.

Behaviours

If we delete a product in Akeneo PIM, will it also be removed from Adobe Commerce?

No. You should probably need some customizations to have this feature.

We think that it is better to never delete a product and use a specific enable/disable attribute state to manage obsolete products.

In Adobe Commerce, the “status” attribute, which is used to say whether a product is enabled or not, takes the value 1 (enabled) or 2 (disabled) (and not 0 or 1 as a boolean)

 

The recommended steps are:

  1. set the product status to disable (not enabled)
  2. synchronize your data with the command line of the connector. Product are deactivated - not enabled anymore. 
  3. if needed, delete the product in the PIM and/Or delete the products in Adobe Commerce.

So, if you really need to delete products, you will need to delete it manually in Akeneo PIM and Adobe Commerce.

If we remove a category from Akeneo PIM, will it be removed from Adobe Commerce after synchronization?

No.

If we change the category structure in Akeneo PIM (positioning, moving parent and sub categories), will it be changed in Adobe Commerce after synchronization?

Yes.

If we have a custom attribute for category in Adobe Commerce, that custom attribute is mandatory, is there any issue when creating category from Akeneo PIM using Akeneo Connector for Adobe Commerce ?

Yes because:

  • Akeneo Connector will import all PIM categories
  • The mandatory attribute will be empty (because PIM categories have no custom attributes).
  • If you edit an Adobe Commerce category, you will have to fill all mandatory attributes.

If we remove some products from a category in Akeneo PIM, will those products be unassigned from the category in Adobe Commerce too?

Yes. The product will be unassigned from the categories on the Adobe Commerce side unless you removed all categories from a product. In this case, the product will not be imported again, and thus not unassigned, as a product should always be assigned under a category and a channel in the PIM to be imported.

Read more about the relationship between the channel and the category tree: Filter via channel

How Akeneo Connector for Adobe Commerce manage select attribute options?

For example, in Akeneo PIM, there is a simple select attribute: Color with these options: "Red", "Blue", "Black".

It will be synchronized by Akeneo Connector for Adobe Commerce

If we remove the option "Red" from Akeneo and synchronize to Adobe Commerce again:

1) Will that option Red also removed from Adobe Commerce attribute option?   
No.

2) What happen for the products which had Red option before?   
Akeneo Connector for Adobe Commerce doesn’t remove this option. You will need to remove it manually in Adobe Commerce (because it is probably link with some products).

3) If we change the option "Blue" to "Light Blue", will it be updated in Adobe Commerce after synchronization?   
Yes

If we have some "custom" product type in Adobe Commerce, such as "Gift Cards". Those products don’t exist in Akeneo PIM, will those products be removed after synchronization because Akeneo PIM is the "master" source?

No. Akeneo Connector for Adobe Commerce keeps products that already exist in Adobe Commerce.

If we assign a product to some categories in Adobe Commerce only, not Akeneo PIM, will that product be removed from the categories after synchronization?

Yes. Akeneo Connector for Adobe Commerce keeps only Akeneo PIM categories. After synchronization, any manual addition is overwritten, any manual deletion is restored.

Can we reset a value of an attribute in Adobe Commerce after synchronization from Akeneo PIM?

Example 1: There is a text attribute: Promotional Message

  1. Today, we want to set it to in Akeneo PIM: "Discount 50%""
  2. Tomorrow, we want to set it to [empty] in Akeneo PIM.
 

If you clear the content of a text attribute (make it empty) in Akeneo PIM it will be synchronized by Akeneo Connector for Adobe Commerce.

Example 2: There is a simple select attribute: Color

  1. Today, we want to set it to in Akeneo PIM: "Red"
  2. Tomorrow, we want to set it to empty in Akeneo PIM.
 

For simple select attribute type, you need to have a “none” option for this attribute to be able to reset it (because you can’t « unselect » a simple select). It will then be synchronized by Akeneo Connector for Adobe Commerce.

Example 3: There is a multi select attribute: Promotion Campaign

  1. Today, we want to set it to “Black Friday” in Akeneo
  2. Tomorrow, we want to set it to blank in Akeneo
 

For multi-select, you can clean all option content in Akeneo PIM, it will be synchronized by Akeneo Connector for Adobe Commerce.

Compatibility with Adobe Commerce features

Does Akeneo Connector support Bundle Product and Group Product?

Since the 101.2.0 version of the Akeneo Connector for Adobe Commerce and for Akeneo Edition 5.XGrowth Edition and Serenity Edition, you can import "Grouped products" in Adobe Commerce (Documentation).

Akeneo Connector for Adobe Commerce doesn’t yet support Adobe Commerce "Bundle Products".

Does Akeneo Connector support Virtual Product and Downloadable Product?

Since the 102.1.0 version of the Akeneo Connector for Adobe Commerce, "Virtual Product" type is supported.

The "Downloadable Product” type is not supported yet by the connector.

If we change the product name in Akeneo, will that change the url_key of the product in Adobe Commerce after synchronization?

Yes. But you need to do a specific mapping for that with Akeneo Connector for Adobe Commerce. Please refer to our documentation for this mapping.

Since the 102.6.0 version of the Akeneo Connector for Adobe Commerce, whenever the url_key of a product changes, the connector will automatically generate a 301 redirect from the old URL to the new URL.

Does Akeneo Connector for Adobe Commerce supports UpSell/CrossSell synchronization from Akeneo PIM to Adobe Commerce? Will that overwrite the Rule Based Relations for UpSell/CrossSell in Adobe Commerce?

In Akeneo PIM you can have a Upsell/CrossSell product association and it will be synchronized by Akeneo Connector for Adobe Commerce with a Up-Sells, and Cross-Sells product relation at product level. Please refer to our documentation about this.

Compatibility with Visual Merchandiser

If we use Visual Merchandiser to assign products to a category by rules, will that be overwritten after synchronize with Akeneo PIM?

No. If you use automatic rules or manual position change of a product with Visual Merchandiser, Akeneo Connector for Adobe Commerce import does not reset these changes.

The association between products and categories will be overwritten by the Connector but the positioning will be preserved.

If we configure Visual Merchandiser for a Category in Adobe Commerce, will the Category get overwritten after synchronization?

No.