> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/master-data-management/item-attributes.md). # 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	Open "Shopware" "Assignment"/"Mapping" Select the "Module Name filter" Map the BC attributes to the Shopware properties.

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

Open "Shopware" "Assignment"/"Mapping"
Select the "Module Name filter"
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: {% stepper %} {% step %} As properties for filter functions. {% endstep %} {% step %} In the specifications on the product page. {% endstep %} {% endstepper %} ### 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. {% hint style="info" %} The variant function requires a corresponding configuration and is not available in all versions. {% endhint %} ### 5. Tips for day-to-day use {% tabs %} {% tab title="Attribute structure" %} * Use consistent attribute names. * Define clear value lists. * Avoid duplicates and near-duplicates. {% endtab %} {% tab title="Performance" %} * Limit the number of attributes per item. * Use option attributes instead of free text wherever possible. * Check the synchronization logs for errors. {% endtab %} {% endtabs %} ### 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.solutioo.de/shopware/shopware6_en_us/master-data-management/item-attributes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.