> 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/frequently-asked-questions-faq/faq-items-and-catalog.md).

# FAQ – Items & Catalog

### Why is my item not uploaded to Shopware?

An item is only transferred if it is marked as **Web Item = Yes**. In addition, the description, price, and the **VAT Prod. Posting Group** must be filled in, because the Shopware tax rate is derived from them. You start the upload via *Actions → Shopware → Upload Product*.

### Why is my item not visible in the shop even though it has been uploaded?

In most cases the **sales channel assignment** is missing: a product is only visible in the channels it is assigned to. Also check whether the item is active in Shopware and assigned to a category. See [Sales Channels on the Item](/shopware/shopware6_en_us/master-data-management/sales-channels-on-the-item.md).

### Can an item be assigned to several categories?

Yes. The **Shopware Categories** field allows a **multi-category assignment**, even though Business Central natively only provides for one category. This way a product appears in several shop categories at the same time.

### How do I transfer formatted product descriptions (bold, lists)?

Via the **Marketing Text** of the item, which is passed to Shopware as HTML. This preserves formatting such as **bold**, *italic*, or bulleted lists. See [Marketing Text & Rich Content](/shopware/shopware6_en_us/master-data-management/marketing-text-and-rich-content.md).

### Can I adopt existing Shopware products instead of creating them anew?

Yes. The connector matches existing products with the BC items based on the **SKU/productNumber** and links the Web ID. Pictures, attributes, and categories can be imported in the process. See [Item Matching & Data Import from Shopware](/shopware/shopware6_en_us/master-data-management/item-matching-and-data-import-from-shopware.md).

### How do variants or configurable items work?

A parent (configurable) item bundles the variants via **Option 1–3** (for example color, size). The connector creates the parent item and the associated variants in Shopware. For details, see [Configurable Items](/shopware/shopware6_en_us/master-data-management/configurable-items.md).

### How do I upload several product images per item?

Store several pictures on the item; the connector transfers them including the cover image and the sort order. See [Item Pictures](/shopware/shopware6_en_us/master-data-management/item-pictures.md).

### How do I maintain multilingual product data?

The name and description can be transferred per language – based on the item translations and the language-dependent marketing text. The language mapping is a prerequisite. See [Multilingual Item Data](/shopware/shopware6_en_us/master-data-management/multilingual-item-data.md).

### How do I set SEO metadata (meta title and meta description)?

The meta title, meta description, and keywords can be maintained per language and transferred to Shopware – for parent items and categories. See [SEO Metadata](/shopware/shopware6_en_us/master-data-management/seo-metadata.md).

### How do I update a very large number of items at once?

Use the bulk upload report with the *Open data only* option to transfer changed items only. It is best to transfer large catalogs outside business hours.

### How do I release an item for transfer to Shopware?

On the Item Card in Business Central, set the **Web Item = Yes** field. Only items marked in this way are taken into account by the Shopware 6 API Connector. After the first successful upload, the **Web ID** is filled automatically and the item is linked to the Shopware product.

### Why does my item not appear in the shop even though it has been uploaded?

Common causes: the item is not assigned to a **sales channel**, it is not set to **active** in Shopware, a **price** for the respective channel is missing, or it is not assigned to a visible **category**. Also check whether the inventory and the visibility settings in the sales channel are correct.

### What is the difference between simple and configurable items?

A **simple item** is a single product without variants. A **configurable item** (variant item) has a parent item and several child items that are distinguished by properties such as color and size. The connector maps configurable items as a Shopware product with variants. For details, see [Configurable Items](/shopware/shopware6_en_us/master-data-management/configurable-items.md) and [Match Variants (Color & Size)](/shopware/shopware6_en_us/data-from-shopware-download-and-matching/match-variants-color-and-size.md).

### How do I transfer item pictures to Shopware?

Pictures are transferred from Business Central to the product in Shopware. You can store a **default picture (cover)** as well as **additional pictures**. Using the download path, you can also retrieve existing media assignments from Shopware. For details, see [Item Pictures](/shopware/shopware6_en_us/master-data-management/item-pictures.md) and [Retrieve Product Images & Media Info](/shopware/shopware6_en_us/data-from-shopware-download-and-matching/retrieve-product-images-and-media-info.md).

### How do I synchronize multilingual product data?

Maintain translations for the name, description, and SEO fields per language in Business Central. The connector transfers the translations to the corresponding language variants of the Shopware sales channel. This gives international shops the correct content for each language. For details, see [Multilingual Item Data](/shopware/shopware6_en_us/master-data-management/multilingual-item-data.md).

### Can I have product descriptions created with AI?

Yes. Using AI support (Copilot), you can generate marketing texts and product descriptions directly in Business Central and then transfer them to Shopware. This saves time when maintaining the catalog. For details, see [AI Support (Copilot)](/shopware/shopware6_en_us/master-data-management/ai-support-copilot.md).


---

# 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/frequently-asked-questions-faq/faq-items-and-catalog.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.
