Item Pictures

Manage and synchronize item pictures between Business Central and Shopware.

Item pictures are essential for a professional online shop. The Shopware 6 API Connector lets you upload and manage product images directly from Business Central.

1. Pictures in Business Central

1.1 Assigning a main image

The main image of an item is managed on the Item Card:

Open the Item Card.

In the picture area (on the right in the default view), click the "Picture" icon.

Select "Import" and upload an image.

You can change the cover image in BC at any time. After synchronization, the changes are automatically applied in Shopware.

1.2 Additional images

For additional product images (gallery):

Open the Item Card.

Again in the right-hand area (default view), you will find the "Picture" menu item. There, click the number shown to the right of "Shopware Additional images".

If no images other than the cover image have been uploaded, 0 is displayed. Otherwise, the number shown corresponds to the total number of additionally uploaded images.

A new "Additional Shopware Images" window opens. Here you can upload additional images and also edit or delete existing ones.

To enable editing, click "+ New" or "Edit List". Then click "Shopware Product Images" on the right and select "Import" to upload another image in addition to the existing cover image.

Repeat steps 3 and 4 to upload further images (one image per line). In the example, three additional images were uploaded alongside the cover image. You can assign individual names in the "Image SEO Description" column.

👉 After you leave the menu, the number of additional images is displayed on the Item Card.

The same applies here: you can change the images in BC at any time. After synchronization, the changes are automatically applied in Shopware.

Images added manually in Shopware are not deleted automatically during synchronization.

2. Supported image formats

✅ Yes

JPEG, PNG, WebP

5 MB

⚠️ Limited

GIF

2 MB

Recommended resolution: at least 800x800 pixels for a good presentation in Shopware.

2. Image synchronization

2.1 Configuration

Open "Shopware" "Settings".

There, in the "Inventory Settings", the "Picture Folder ID" must be configured accordingly. Under "Picture Folder ID", enter the ID of the Shopware media folder.

2.2 Uploading a single image

Open the Item Card.

Click "Actions" "Shopware" " Upload Product"

The main image and all additional images are uploaded.

2.3 Uploading pictures for several items

Open the item list ("Sales" "Items")

Select the items you want. Click "Actions" "Shopware" "Import Default Images". The item pictures of the selected items are uploaded.

3. Shopware media folder

Folder structure

Images are stored in the configured media folder:

Media/
├── Product Media/
│   ├── item-picture-001.jpg
│   ├── item-picture-002.jpg
│   └── ...

Finding the folder ID

Open the Shopware backend
Navigate to Content → Media
Click the folder you want.
You will find the ID in the URL.

4. Tips for day-to-day work

Use high-resolution images (min. 800x800 px).
Make sure image sizes are consistent.
Optimize images for the web (compression).

Use meaningful file names.
Avoid special characters and umlauts.
Example: itemno-001-front.jpg

Upload images outside of peak hours.
Compress large images before uploading.
Monitor the Activity Log.

Frequently Asked Questions

How do the images get from Business Central to Shopware?

ImportBaseImages takes over the BC standard images as "SOUSHW Item Picture". Upload_ItemImages and Upload_Media then upload the files to Shopware via the media and product-media endpoints and assign them to the product; SetCoverImage defines the cover image.

Does the connector prevent the same image from being uploaded more than once?

Yes. Before the upload, isFileNameAlreadyUploaded uses search/media to check by file name whether the image already exists in Shopware. This prevents identical media from being created twice.

PreviousItem Categories NextGroup Items & Product Bundles