> 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/data-from-shopware-download-and-matching/retrieve-product-images-and-media-info.md).

# Retrieve Product Images & Media Info

Images are a central part of a product catalog. The Shopware 6 API Connector manages item pictures in both directions: it uploads images from Business Central to Shopware **and** can **retrieve media information from Shopware** in order to keep the assignment between both systems consistent. This page explains in detail which image and media functions are available and how the download and matching work.

**How images are linked**

In Shopware, every image has a **media ID** and – as soon as it is assigned to a product – a **product media assignment**. In Business Central, these identifiers are stored on the image record:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Shopware Image ID (media ID)</strong></td><td>Unique identifier of the media file in Shopware.</td></tr><tr><td><strong>Product Assignment ID</strong></td><td>Link that assigns a media file to a specific product.</td></tr><tr><td><strong>isCover</strong></td><td>Identifies the cover image (main image) of the product.</td></tr><tr><td><strong>Import from Main</strong></td><td>Flags images that were adopted from the BC default picture.</td></tr></tbody></table>

**Retrieving media info from Shopware**

With the **Retrieve Media Info** function (Download Product Media Info), the connector fetches the current **product media assignments** from Shopware and matches them with the image records in Business Central. The procedure in detail:

{% stepper %}
{% step %}
**Load the assignments**

The connector calls the Shopware endpoint for product media and receives the **assignment ID** and the **media ID** for each assignment.
{% endstep %}

{% step %}
**Match the images**

For each media ID, the connector looks for the matching image in BC (using the stored Shopware Image ID) and adds the **Product Assignment ID**.
{% endstep %}

{% step %}
**Detect orphaned images**

Assignments for which there is no (longer a) matching image in BC are identified as orphaned, and the corresponding images are removed in Shopware.
{% endstep %}

{% step %}
**Result**

At the end, the connector reports **how many records were updated** and **how many images were deleted in Shopware**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
This matching run is particularly useful if some images were maintained directly in Shopware. It ensures that BC knows the correct assignment IDs and that later image updates are applied accurately.
{% endhint %}

**Adopting default pictures from Business Central**

With **Import Default Images**, the **default item picture** from Business Central is added as an image to the item's Shopware image list. If no cover image exists yet, the adopted image is automatically marked as the **cover image**. This lets you ensure in a single step that every item has at least its BC main image in the shop.

**Controlling the cover image**

The **cover image** is the main image that is displayed prominently in the shop. The connector can set the cover image in Shopware; conversely, when data is imported from Shopware, the cover image there can be set as the **default picture in BC**. The order of additional images is controlled by a **sequence number**.

**Additional image functions**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Additional images</strong></td><td>In addition to the default picture, several further product images can be managed and uploaded.</td></tr><tr><td><strong>Import from device</strong></td><td>Images can be imported directly from your computer as additional Shopware images.</td></tr><tr><td><strong>Download image</strong></td><td>Individual images or a ZIP package containing several images can be downloaded from BC.</td></tr></tbody></table>

**How this relates to other pages**

* Complete image maintenance (order, cover image, multiple images, alt text) is described on the [Item Pictures](/shopware/shopware6_en_us/master-data-management/item-pictures.md) page.
* The image download is part of the comprehensive [Item Matching & Data Import from Shopware](/shopware/shopware6_en_us/master-data-management/item-matching-and-data-import-from-shopware.md).

**Troubleshooting**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Image without assignment</strong></td><td>The Product Assignment ID is missing – retrieve the media info to add the assignment.</td></tr><tr><td><strong>Duplicate image in the shop</strong></td><td>Orphaned assignment – the media matching run removes surplus images in Shopware.</td></tr><tr><td><strong>No cover image</strong></td><td>Import the default picture; the first image is set as the cover.</td></tr></tbody></table>

### Frequently Asked Questions

#### Can I retrieve images and media information from Shopware back to Business Central?

Yes. `DownloadProductMediaInfo` reads the media information of a product from Shopware. Using the "Download Item Pictures" action, you can download the images individually or together as a ZIP file – useful for making images that were maintained in Shopware available in BC.


---

# 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/data-from-shopware-download-and-matching/retrieve-product-images-and-media-info.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.