Item Attributes

Manage and synchronize item attributes between Business Central and Shopware.

Item attributes let you define additional properties for items that are displayed in Shopware as product properties or specifications.

1. Attributes in Business Central

1.1 Creating attributes

1. Navigate to "Items" "Item Attributes".
2. Create new attributes (for example color, material, size).
3. Define the possible values.

1.2 Assigning attributes

1. Open the "Item Card".
2. Navigate to "Related" "Item" "Attributes".
3. Assign the attributes and values you want.

2. Attribute synchronization

Attribute mapping / assignment

Attributes are synchronized to Shopware automatically if:

• The attribute is assigned to a "web item".
• The attribute is mapped in the mapping table.

Setting up the mapping / assignment

1. Open "Shopware" "Assignment"/"Mapping"
2. Select the "Module Name filter"
3. Map the BC attributes to the Shopware properties.

3. Attribute values

3.1 Value types

Business Central supports several value types:

Type	Description	Example
Option	Selection from predefined values	Red, Blue, Green
Text	Free text	"Premium quality"
Integer	Whole numbers	42
Decimal	Decimal numbers	3.14

3.2 Synchronizing values

Attribute values are transferred to Shopware automatically:

1

As properties for filter functions.

2

In the specifications on the product page.

4. Variants and properties

4.1 What are Shopware properties?

Shopware properties are product characteristics that let you describe and filter items in Shopware in a structured way. They are used to represent characteristics such as size, color, material or technical specifications in a standardized form.

Unlike variants (for example sizes S, M, L as selectable versions of a product), properties are usually purely descriptive. They typically appear in the product details and are frequently used for filter functions in categories so that customers can search specifically for certain characteristics.

They are used, for example, for:

• Filter navigation in the shop
• Product comparisons
• Search results

4.2 Shopware options (variants)

For product variants (for example a T-shirt in different sizes):

1. Create a "master item" in BC.
2. Define "variants" with different attribute values.
3. Synchronize the master item to Shopware.

The variant function requires a corresponding configuration and is not available in all versions.

5. Tips for day-to-day use

Attribute structure

• Use consistent attribute names.
• Define clear value lists.
• Avoid duplicates and near-duplicates.

Performance

• Limit the number of attributes per item.
• Use option attributes instead of free text wherever possible.
• Check the synchronization logs for errors.

Frequently asked questions

How do I upload individual attributes or all pending attributes to Shopware?

You upload individual attributes using the "SOUSHW Upload Attribute" action. For a bulk upload of all attributes that have not yet been synchronized, use Upload_PendingItemAttributes; the "SOUSHW Item Attribute Mgnt." codeunit is also job queue capable and can run the attribute upload automatically.