Skip to main content
Akeneo Integration

Akeneo Product Cloud App enables Akeneo integration with EvolutionX. We cover setup, use cases, category sync and more.

Ricardo Santos avatar
Written by Ricardo Santos
Updated over a week ago

Hide simple products

In the Akeneo setup, we can enable the "Hide simple products" toggle, so the users can see only the master products in the Storefront.

Master Products (Configurable products): Show cheapest price

πŸ‘ Important: This applies to products pulled from Akeneo

If you wish to show the lowest price when displaying configurable master products, then you can achieve this by doing to following.

  1. Find the lowest priced product in Akeneo for that configurable product

  2. Create/Map an attribute called "default_options" (Don't include the quotes only the value)

  3. Set the attribute to a value of "yes" (Don't include the quotes only the value)

  4. Wait for your Akeneo products to update

  5. You should see a price now displaying for the master product

Sync Menus from Akeneo

After the initial setup, Akeneo categories will be synced with EvoX.

These categories have a dedicated menu link type named 'Akeneo Category'.

While regular categories will add a menu item of type category per category selected:

Any menu can also have Akeneo categories added and live with the remaining menu items - the difference is that all categories will be presented in the menu manager under a single menu item.

The structure selected for this item will remain intact anywhere it is placed in the menu.

Items of type Akeneo Categories can be placed as a child of any other menu item, but this type can not have any children added under it.

The structure must be changed by editing the menu item.

CSS Classes

Adding a css class to an Akeneo menu item has a special behavior when no name is added to the item. When this happens, a node for the Akeneo Categories menu item will still be added with the name (no parent name)

and the css class will be applied to all the immediate elements added to the first level in this menu

If a name is added to the menu, then the css class will be applied to this parent node only as with every other menu item.


While a category tree can have multiple depth levels, all menus are only displayed to the storefront down 3 levels (the menu item name counts as 1 level).

Synchronizing modifications

Whenever a category in use by a menu gets renamed or deleted from Akeneo, a routine will run (after the daily routine to sync Akeneo categories with EvoX) and the menu will be updated to match with the new name.

If a category selected in a menu gets removed from Akeneo, the menu will also lose that item. Please remember that any sub-menu items under that category will also be removed.

The menu structure is not changed when categories are moved to different branches, if a category gets moved to a different level, the menu item will keep the previous structure. You can at any time visit the Menu Manager and update the menu structure by editing the respective Akeneo Category item.

If you add subcategories to your Akeneo category tree from the EvoX categories and use them in menus, after renaming these subcategories in EvoX, the menu will not be immediately updated.

It will with the next category synchronization routine from Akeneo but if you don't want to wait, you can force the synchronization of all menus by editing any menu and clicking the button Pull Menu From Akeneo.

A confirmation message will show and all menus using Akeneo categories will be updated with the Akeneo vertical currently in EvoX.

Did this answer your question?