> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alumio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Synchronize Shopware Property Group or Custom Field from Akeneo Attribute

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"**.
  <Frame>
    <img src="https://mintcdn.com/alumio/qrKOuJWGl3LPMg2r/images/image-204.png?fit=max&auto=format&n=qrKOuJWGl3LPMg2r&q=85&s=a3104937ab189d63488e8156aa84e70a" alt="Image" width="1349" height="855" data-path="images/image-204.png" />
  </Frame>
* Set a schedule expression and enable the configuration.
* Go to **"Integrations → Schedulers → Shopware - Send - Property Groups or Custom Fields"**.
  <Frame>
    <img src="https://mintcdn.com/alumio/qrKOuJWGl3LPMg2r/images/image-205.png?fit=max&auto=format&n=qrKOuJWGl3LPMg2r&q=85&s=ff9c5e38e376786f4a6cd1393809bd2d" alt="Image" width="1349" height="855" data-path="images/image-205.png" />
  </Frame>
* Set a schedule expression and enable the configuration.