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
Navigate to "Items" "Item Attributes".
Create new attributes (for example color, material, size).
Define the possible values.


1.2 Assigning attributes
Open the "Item Card".
Navigate to "Related" "Item" "Attributes".
Assign the attributes and values you want.

2. Attribute synchronization


3. Attribute values
3.1 Value types
Business Central supports several value types:
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:
As properties for filter functions.
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):
Create a "master item" in BC.
Define "variants" with different attribute values.
Synchronize the master item to Shopware.
5. Tips for day-to-day use
Use consistent attribute names.
Define clear value lists.
Avoid duplicates and near-duplicates.
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.
