Skip to main content
This section will explain how to properly sync all families and attributes from Akeneo into the Shopware property group or custom field. Akeneo and Shopware use fundamentally different data models, which means attributes cannot be transferred directly from one system to the other without structural mapping. Akeneo stores product information as flexible, typed attributes, while Shopware organizes similar data into property groups for filterable or variant-defining attributes and custom fields for additional descriptive or technical information. To preserve functionality such as storefront filtering, variant generation, and multilingual attribute display, Akeneo attributes must be transformed into the appropriate Shopware structures. Simple-select and multi-select attributes that influence product selection or filtering are mapped into Shopware property groups and options, whereas informational, numeric, or free-text attributes are mapped into Shopware custom fields. This mapping ensures that data from Akeneo is represented correctly within Shopware’s ecosystem and behaves consistently in product listings, filters, and detail pages. The step to do this is by:
  1. Fetching attributes from Akeneo by running the Incoming “Akeneo - Fetch - Attributes”.
  2. Sending property group or custom field into Shopware by running the Route “Synchronize Property Group or Custom Field - from Akeneo Attribute” and the Outgoing “Shopware - Send - Property Group or Custom Field”.

​
Fetching attributes from Akeneo

In Alumio, go to “Integrations → Incoming → Akeneo - Fetch - Attributes” This incoming will create a task inside Alumio with data structured as an Alumio base attribute. There are transformers inside this Incoming before processing this attribute:
  1. Akeneo - Prepare convert - Labels - To localization.
  2. Akeneo - Check and fetch - Attribute options.
  3. Akeneo - Convert - Attribute - To Alumio Base Attribute.
  4. Akeneo - Map - Type code - To Alumio Base code.
  5. Akeneo - Filter previous - Attribute.
Akeneo - Prepare convert - Labels - To localization
This transformer will prepare the labels in Alumio Base. Akeneo - Check and fetch - Attribute options
  • This transformer will fetch the options from the attribute options when the attribute type is a simple select or multiselect.
  • This transformer will fetch the options from the entity records when the attribute type is reference entity or reference entity
Akeneo - Convert - Attribute - To Alumio Base Attribute
This transformer will convert the attribute structure into Alumio Base. Akeneo - Map - Type code - To Alumio Base code
This transformer will convert the attribute code value into Alumio Base. Akeneo - Filter previous - Attribute
This transformer will filter the Attribute from the previous iteration to avoid duplication.

​
Sending a property group or a custom field into Shopware

In Alumio, go to “Integrations → Route → Synchronize Property Group or Custom Field - from Akeneo Attribute”. Then go to the outgoing “Shopware - Send - Property Group or Custom Field”. This Outgoing will transform the Alumio Base attributes into a Shopware property group when it has options and a custom field when it does not. There are transformers inside the Outgoing configuration. You can begin by selecting which attributes should be processed by the “Shopware – Check and Send – Property Group or Custom Field” transformer. Shopware - Check and send - Property Group or Custom Field
This transformer will check what kind of attribute to determine the Shopware property group when it has options and a custom field when it does not. Shopware - Convert - Config label - from Alumio Base Localizations
This transformer will make the Shopware config label from Alumio Base Localizations. Shopware - Custom field set - Create and send
This transformer will prepare a custom field set where the field set will be created, and continue to call the transformer “Shopware - Check and send - Custom field” for real creation. Shopware - Check and send - Custom field
This transformer will check the custom field from the previous iteration and decide to create a new one or update the existing. Shopware - Prepare convert - Translations - from Alumio Base localizations
Create Shopware translations from Alumio’s base localizations. Shopware - Prepare convert - Property Group Options - From Alumio Base Attribute Options
Preparing Shopware property group options from Alumio base attribute options. Shopware - Convert - Property group - from Alumio Base Attribute
This transformer will convert the property group from Alumio base attributes and previous preparation. Shopware - Check and send - Property group
This transformer will check the property group from the previous iteration and decide to create a new one or update the existing.

​
Automatic property groups or custom fields synchronization setup

  • Go to “Integrations → Schedulers → Akeneo - Fetch - Attributes”.
    Image
  • Set a schedule expression and enable the configuration.
  • Go to “Integrations → Schedulers → Shopware - Send - Property Groups or Custom Fields”.
    Image
  • Set a schedule expression and enable the configuration.