# Artikelbilder

Artikelbilder sind essentiell für einen professionellen Onlineshop. Der Shopware 6 API Connector ermöglicht das Hochladen und Verwalten von Produktbildern direkt aus Business Central.

## 1. Bilder in Business Central

### 1.1 Hauptbild zuweisen

Das Hauptbild eines Artikels wird über die [**Artikelkarte**](https://docs.solutioo.de/shopware/stammdatenverwaltung/pages/3TagCMHYbK1VVo5E9CFf#id-2.-kurzbeschreibung-artikelkarte) verwaltet:

{% columns %}
{% column %}
{% stepper %}
{% step %}
Öffnen Sie die *Artikelkarte*.
{% endstep %}

{% step %}
Klicken Sie im Bild-Bereich (in der Standardansicht rechts) auf das *"Bild"*-Symbol.
{% endstep %}

{% step %}
Wählen Sie *"Importieren"* und laden Sie ein Bild hoch.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column %}

<div align="left" data-with-frame="true"><figure><img src="/files/uvBCh5wxaUcpfPrRjVsp" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
Das Titelbild kann jederzeit in BC angepasst werden. Nach der Synchronisation werden die Änderungen automatisch in Shopware übernommen.
{% endhint %}

### 1.2 Zusätzliche Bilder

Für zusätzliche Produktbilder (Galerie):

{% stepper %}
{% step %}
Öffnen Sie die [Artikelkarte](https://docs.solutioo.de/shopware/stammdatenverwaltung/pages/3TagCMHYbK1VVo5E9CFf#id-2.-kurzbeschreibung-artikelkarte).
{% endstep %}

{% step %}
Wieder im rechten Bereich (Standardansicht) finden Sie den Menüpunkt *"Bild"*. Klicken Sie dort auf die Zahl, die rechts neben *"Shopware Additional images"* steht.&#x20;

{% hint style="info" %}
Wenn keine zusätzlichen Bilder zum Titelbild hochgeladen wurden, wird **0** angezeigt. Andernfalls entspricht die angezeigte Zahl der **Gesamtanzahl der zusätzlich hochgeladenen Bilder**.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="/files/pOKe7Ch3445wENPOUXQA" alt="" width="181"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Es öffnet sich ein neues Fenster "Additional Shopware Images". Nun können Sie zusätzliche Bilder hochladen aber auch Bilder bearbeiten oder wieder löschen.

<div align="left" data-with-frame="true"><figure><img src="/files/oTxLUlseKMsm90K0Tgfr" alt=""><figcaption><p><em>"Additional Shopware Images"</em> Menü, nur Ansicht</p></figcaption></figure></div>

Um die Bearbeitung zu aktivieren, klicken Sie auf *„+ Neu“* oder *„Liste bearbeiten“**.*** Klicken Sie anschließend rechts auf *„Shopware Product Images“* und wählen Sie *„Import“*, um ein weiteres Bild zum bestehenden Titelbild hochzuladen.

<div align="left" data-with-frame="true"><figure><img src="/files/x1jDRcH6nBVJvjs5zDgt" alt=""><figcaption><p><em>"Additional Shopware Images"</em> Menü, in Bearbeitung</p></figcaption></figure></div>
{% endstep %}

{% step %}

<div align="left" data-with-frame="true"><figure><img src="/files/91Uh0sxKqy2uXzvUm4vX" alt="" width="329"><figcaption><p>Geöffnetes Fenster für den Bilderupload</p></figcaption></figure></div>
{% endstep %}

{% step %}
Wiederholen Sie die Schritte 3 und 4, um weitere Bilder hochzuladen (ein Bild pro Zeile). Im Beispiel wurden neben dem Titelbild drei zusätzliche Bilder hochgeladen. Individuelle Bezeichnungen können in der Spalte *„Image SEO Description“* vergeben werden.

<div align="left" data-with-frame="true"><figure><img src="/files/UY7fLCTstdYeEEqx8uvD" alt=""><figcaption><p>Upload von drei Bildern und angepasster Beschreibung</p></figcaption></figure></div>
{% endstep %}

{% step %}
👉 Nach dem Verlassen des Menüs wird in der Artikelkarte die Anzahl der zusätzlichen Bilder als Zahl angezeigt.

<div align="left" data-with-frame="true"><figure><img src="/files/qMWb9az7OWeZOycFaW79" alt="" width="179"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Auch hier gilt: Die Bilder können jederzeit in BC angepasst werden. Nach der Synchronisation werden die Änderungen automatisch in Shopware übernommen.
{% endhint %}

{% hint style="warning" %}
Manuell in Shopware hinzugefügte Bilder werden bei der Synchronisation nicht automatisch gelöscht.
{% endhint %}

### 2. Unterstützte Bildformate

<table data-view="cards"><thead><tr><th align="center"></th><th align="center"></th><th align="center"></th></tr></thead><tbody><tr><td align="center">✅ Ja</td><td align="center"><p>  <i class="fa-file-jpg">:file-jpg:</i>      <i class="fa-file-png">:file-png:</i>      <i class="fa-newspaper">:newspaper:</i> </p><p><strong>JPEG, PNG, WebP</strong></p></td><td align="center">5 MB</td></tr><tr><td align="center">⚠️ Eingeschränkt</td><td align="center"><p><i class="fa-gif">:gif:</i></p><p><strong>GIF</strong></p></td><td align="center">2 MB</td></tr><tr><td align="center"></td><td align="center">Empfohlene Auflösung: mindestens <strong>800x800 Pixel</strong> für eine gute Darstellung in Shopware.</td><td align="center"></td></tr></tbody></table>

## 2. Bildsynchronisation

### 2.1 Konfiguration

{% stepper %}
{% step %}
Öffnen Sie die *"Shopware"* <i class="fa-right">:right:</i> "*Einstellungen"*.

<div align="left" data-with-frame="true"><figure><img src="/files/259IeC6giHlb0FWpltlc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Dort in den *"Lager-Einstellungen"* muss die ***„Bilder Ordner-ID“*** ***/ "Picture Folder ID"*** entsprechend konfiguriert sein. Geben Sie unter *"Bilder Ordner-ID" / "Picture Folder ID"* die ID des Shopware-Medienordners ein

<div align="left" data-with-frame="true"><figure><img src="/files/wYXO9L6ejJuLcMjGoZyK" alt=""><figcaption><p>Lagereinstellungen: <em>"Bilder Ordner-ID" / "Picture Folder ID"</em> </p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 2.2 Einzelnes Bild hochladen

{% stepper %}
{% step %}
Öffnen Sie die [Artikelkarte](https://docs.solutioo.de/shopware/stammdatenverwaltung/pages/3TagCMHYbK1VVo5E9CFf#id-2.-kurzbeschreibung-artikelkarte).
{% endstep %}

{% step %}
Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* <i class="fa-right">:right:</i> *"*<i class="fa-up">:up:</i> *Produkt hochladen"*

Das Hauptbild und alle zusätzlichen Bilder werden hochgeladen.

<div align="left" data-with-frame="true"><figure><img src="/files/HZH7Iu8vNhs4WDxb7oX6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 2.3 Mehrere Artikel-Bilder hochladen

{% stepper %}
{% step %}
Öffnen Sie die Artikelliste (*"Verkauf"* <i class="fa-right">:right:</i> *"Artikel")*
{% endstep %}

{% step %}
Wählen Sie die gewünschten Artikel aus. Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* <i class="fa-right">:right:</i> *"Import Default Images".* Die Artikelbilder der ausgewählten Bilder werden hochgeladen.

<div align="left" data-with-frame="true"><figure><img src="/files/NncCjv0laGrMkcAtu9I0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## 3. Shopware-Medienordner

{% columns %}
{% column %}

### Ordnerstruktur

Bilder werden im konfigurierten Medienordner gespeichert:

```
Medien/
├── Product Media/
│   ├── artikelbild-001.jpg
│   ├── artikelbild-002.jpg
│   └── ...
```

{% endcolumn %}

{% column %}

### Ordner-ID finden

1. Öffnen Sie das **Shopware-Backend**
2. Navigieren Sie zu **Inhalte** → **Medien**
3. Klicken Sie auf den gewünschten Ordner.
4. Die ID finden Sie in der URL.
   {% endcolumn %}
   {% endcolumns %}

## 4. Best Practices

{% tabs %}
{% tab title="Bildqualität" %}

* Verwenden Sie hochauflösende Bilder (min. 800x800 px).
* Achten Sie auf einheitliche Bildgrößen.
* Optimieren Sie Bilder für das Web (Komprimierung).
  {% endtab %}

{% tab title="Dateibenennung" %}

* Verwenden Sie aussagekräftige Dateinamen.
* Vermeiden Sie Sonderzeichen und Umlaute.
* Beispiel: `artikelnr-001-frontal.jpg`
  {% endtab %}

{% tab title="Performance" %}

* Laden Sie Bilder außerhalb der Stoßzeiten hoch.
* Komprimieren Sie große Bilder vor dem Upload.
* Überwachen Sie das Aktivitätsprotokoll.
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.solutioo.de/shopware/stammdatenverwaltung/artikelbilder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.