> 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/configurable-items.md).

# Configurable Items

To create a configurable item, all variants must first be created as [(Simple) Items](/shopware/shopware6_en_us/master-data-management/simple-items.md).

This explanation assumes the standard view. Follow the path below to create a new item (master item):

*Shopware* <i class="fa-right">:right:</i> *Related* <i class="fa-right">:right:</i> *Linked items (parent)*

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FGxfBrwRT3ywCmfMQqyUk%2FBildschirmfoto%202025-12-17%20um%2017.39.29.png?alt=media&#x26;token=1672deff-34ca-4f52-a4b2-b93575dd70f6" alt=""><figcaption></figcaption></figure></div>

On the page that opens, first click *„+ New“* and then enter all product details.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FPwYEr56Ex5kw0qWGWfzQ%2FBildschirmfoto%202025-12-17%20um%2017.40.16.png?alt=media&#x26;token=5aea747d-5444-4cce-ac9d-59f4b12d7754" alt=""><figcaption></figcaption></figure></div>

The product details are displayed. The following two screenshots show a standard view with all editable properties. These can be adjusted individually depending on your settings.

The individual fields are explained below.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FqrDBixkgQJhvvveulTMN%2FBildschirmfoto%202026-02-25%20um%2010.45.11.png?alt=media&#x26;token=db86e7a1-8847-4741-95b4-e271c4a55a43" alt=""><figcaption></figcaption></figure></div>

#### 1. General

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FgBrPxbBWZRqkOLfe4YMj%2FBildschirmfoto%202026-02-25%20um%2010.47.14.png?alt=media&#x26;token=e3964120-4181-4f54-a9b0-12c96c28e278" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Please note that the numbers (item numbers) must be created first, so that names (product names) can be assigned afterwards.
{% endhint %}

#### 2. Variants

Up to three option attributes can be assigned to the item. At least one attribute must be assigned. Depending on your selection, the product is linked accordingly.

{% hint style="danger" %}
Important: The simple product must also contain the corresponding linking attribute; otherwise an error message is displayed.
{% endhint %}

Example with one attribute: ![](https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FOszf42Yhg61mEz7qTwgH%2FBildschirmfoto%202025-12-17%20um%2017.42.01.png?alt=media\&token=0bfe4899-3c8a-48a8-ad6d-7beb0e0c754b)

Example with two attributes: ![](https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FxyFndMPtFam66gXZEYK2%2FBildschirmfoto%202025-12-17%20um%2017.42.20.png?alt=media\&token=02cf2929-dce7-4ce3-8dba-35fc5bea69ee)

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fui9kFnhYz7ghE5ZYxlDm%2FBildschirmfoto%202025-12-17%20um%2017.50.41.png?alt=media&#x26;token=e3c8e138-2009-4dd2-93b8-bef64799ed3d" alt=""><figcaption></figcaption></figure></div>

#### 3. Shopware information

Here you can see whether the product has already been synchronized to Shopware and at what time this happened. In addition, the associated Shopware ID and the respective status reason are shown clearly.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F4FHcYTuy6sbPfwhjggrM%2FBildschirmfoto%202025-12-17%20um%2017.51.25.png?alt=media&#x26;token=9cdfe47b-b4fd-424c-ac5b-0bc83fc75488" alt=""><figcaption></figcaption></figure></div>

#### 4. Sales Channel

The sales channel indicates in which shop the product is available. You can decide yourself in which shop the item is offered.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fslt8sesaOtahyanXypqV%2FBildschirmfoto%202025-12-17%20um%2017.52.02.png?alt=media&#x26;token=93179031-098c-4909-8295-d2e9fd6e1852" alt=""><figcaption></figcaption></figure></div>

#### 5. Shopware product pictures

Follow the path *Shopware product pictures* <i class="fa-right">:right:</i> *List*. All product pictures, including those of the simple items, are listed there. Select the title picture by ticking it in the list.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FaNO8RqCNt3WNBCfv3Su8%2FBildschirmfoto%202026-02-25%20um%2010.50.48.png?alt=media&#x26;token=88d319da-86f9-4d16-bcea-8561a51e4da6" alt=""><figcaption></figcaption></figure></div>

If no pictures are available yet, select *"+ New"* in the bar at the top and then *"Shopware product pictures"* on the right. In the drop-down menu that opens, click *"Import"*. Drag the picture you want directly into the open window or upload it using the *"Browse"* function.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fk9wN8944FXv25Xl53hWr%2FBildschirmfoto%202025-12-17%20um%2017.52.38.png?alt=media&#x26;token=0f20b6e2-ca78-4928-8162-2c0a9a0d4b92" alt=""><figcaption></figcaption></figure></div>

#### 6. Assignment and upload

Once all necessary details have been entered, the item must be assigned to a category. To do this, click the *"Assign simple products"* button. If the upload is successful, the product then appears in the *"Simple product"* list.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F9OROMMumfTKZ4wzCypVX%2FBildschirmfoto%202025-12-17%20um%2017.53.25.png?alt=media&#x26;token=d8b42b4e-6df8-495d-8183-72b0e9499623" alt=""><figcaption></figcaption></figure></div>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/shopware6_en_us/master-data-management/configurable-items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
