Skip to content

Shopware 6 Items

List view of all items configured for Shopware 6. The list gives a compact overview of the status, prices and quantities of each item. Clicking an entry opens the detailed item card.

The list is read-only – changes are made via the item card.

Opening the page

  • Via Search: Shopware 6 Items
  • Via the Dashboard → action Items
  • Via the dashboard by clicking a KPI tile

Fields

Field Description
Shop The Shopware 6 shop this item row belongs to – shown by the shop's name from the shop list. One item can have one row per shop. To filter or sort, use the Shop Code column.
Shop Code Technical shop code (sub-account) of this item row (hidden by default).
Item No. BC item number. Links the Shopware item to the BC item master; clicking it opens the BC item card.
Item Description Item description from the BC item card.
Title Item title in the shop (hidden by default).
SKU Stock keeping unit – unique item identifier in the shop (hidden by default).
Item Online Shows whether the item exists in the shop. Only items with this flag are taken along by the automatic item sync; whether the shop displays the product is controlled by Activated.
Item Synced The shop version matches what Business Central last read or wrote – set by a successful upload as well as by the download from the shop.
Activated Shows whether the item is activated for display in the shop.
Marketplace Quantity Quantity last transferred to the shop. Unless Quantity Fixed is enabled, it is recalculated from the Business Central inventory on every upload and quantity sync.
Marketplace Price Price transferred to the shop. Unless Price Fixed is enabled, merchantCENTRAL takes it from the sales price list of the shop – see Prices from merchantCENTRAL.
Sync Timestamp Timestamp of the last transfer to the shop.
Update Item Flag: the item data needs to be uploaded to the shop.
Update Price Flag: the price needs to be updated in the shop.
Update Quantity Flag: the quantity needs to be updated in the shop.
Variant Master The variant master this item is assigned to as a variant.
Sync Failure Count Number of consecutive failed automatic uploads (highlighted in colour). At 5 failures the item is parked and skipped by the sync until it is reset via the Reset Sync Failures action. The Sync Errors view filters all items with failures.
Sync Retry After Earliest time the automatic sync retries this item after a failure (hidden by default).

Automatic update

The item sync of the job queue (SYNC, every 2 minutes) uploads every item that carries Item Online and Update Item, and clears Update Item afterwards – Upload Selected Items is not needed for that. The flag is set by every change to the shop fields of the item card, by Activate Selected Items / Deactivate Selected Items and by Flag All for Update in the merchantCENTRAL list Marketplace Items.

Stays behind because … Where you see it
the item has no valid price or the price check blocks it. A new item is only created once it has a price; a blocked price does not count as a failed attempt. Price Error on the item card, dashboard Blocked Prices / Items Without Price – see Prices from merchantCENTRAL.
the upload failed several times. Sync Failure Count, Sync Retry After, view Sync Errors.
the item is a variant of an online variant master. Variant Master. The sync flags the master and uploads it in the same run; the change reaches the shop through the parent product.

You park an item by clearing Update Item on the item card by hand – this list is read-only.


Actions

The actions for selected items first check that Shopware 6 is enabled and licensed in the hub; otherwise the action stops with a message. All products at once are downloaded by the Data Takeover in the step All Products – see the dashboard.

Action Description
Activate Selected Items / Deactivate Selected Items Marks the selected items as active or inactive for the shop. The change takes effect in Shopware with the next upload of the items.
Upload Selected Items Uploads all selected items to the shop (with a progress dialog). Items that are variants of an online variant master are skipped – they are uploaded via their master. The result message counts them as skipped.
Upload Product Documents Uploads the product documents of the selected items to the shop media and updates the products' custom fields, without a full item upload. Prices, texts and SEO data stay untouched.
Download Selected Items Downloads the shop data of the selected items and overwrites the BC data (title, description, SEO, status) after confirmation. Prices are not read back.
Copy Long Text to Marketing Text Copies the long description of the selected items into their Marketing Text – the editable base for the description template. Items that already have a marketing text are skipped. Run this before applying the template.
Reset Sync Failures After a confirmation naming the number of items, clears the failure counter and backoff of the selected items so the automatic sync retries them immediately. Background: after 5 failed uploads in a row an item is parked and skipped by the automatic sync.
Assign to Shop... After a confirmation, assigns the selected items to another Shopware 6 shop by creating a per-shop item row for each.
Assign to All Enabled Shops After a confirmation, ensures the selected items have a row for every enabled Shopware 6 shop.
Remove from this Shop After a confirmation (default No), removes the selected item rows from their current shop – the BC items are not deleted.
Remove Orphaned Rows Removes item rows whose BC item no longer exists – typically leftovers of variant-container downloads (SKU suffix, e.g. “…M”). Such rows can neither be opened nor deleted normally. The action first shows the count and sample item numbers; after confirmation the rows are deleted including their attribute, tag, category, visibility and cross-selling assignments. Products in the shop are not touched.
Variant Masters Opens the list of variant masters.

Prices come from the merchantCENTRAL price sync, quantities from the stock sync. To send a shop again in full: shop card → Sync Prices and Stock.

Assignments, images and cross-selling are fetched from the shop once after a shop migration by the Data Takeover (setup → Data Takeover), steps Assignments, Images and Cross-Selling. Fetch the master data from the shop first, otherwise assignments cannot be resolved.