Product Synchornization
1 Synchronisation Methods
Please make sure that
Changelog Entity Sync
Every 10 minutes
Only products that changed since the previous run
Automatic — no configuration required
Full Catalogue Sync
Daily, at the scheduled hour
Entire product catalogue
Enable Daily Product Synchronisation in Settings → Extensions → Nosto
Manual Full Sync
On demand
Entire product catalogue
Marketing → Nosto Job Listing → Schedule Full Product Sync

2 Required Fields
Synchronisation will fail unless every product contains the seven mandatory attributes below.
product_id
name
url
image_url
availability
price
(null values default to 0; no warning)
price_currency_code
Tip — placeholder images Shopware allows products without images. From Nosto v3.3.9 / v4.2.9 onward, such items receive
image_url = /bundles/storefront/assets/icon/default/placeholder.svg
. Ensure that file exists or the product will sync but remain Not promotable.
3 Shopware Defaults vs. Nosto
Name, Product Number, Price (gross/net) are mandatory UI fields in Shopware.
product_id
andurl
are generated on save.Stock defaults to 0 if left blank.
A product saved without images displays fine in Shopware but requires the placeholder rule above to stay promotable in Nosto.
4 Impact of Clearance sale & Hide products after clearance
≥ 1
—
—
Always visible, purchasable
InStock
0
Off
Off or On
Visible (can’t buy)
InStock
0
On
Off
Visible (can’t buy)
OutOfStock
0
On
On
Hidden
Discontinued (if previously synced)
Please familiarise yourself with Clearance Sale & Hide products after clearance
5 Key Nosto Plugin Options
Sync inactive products
Mirrors Shopware logic for inactive items (needed if you rely on variant fall-backs).
Sync first available variant
Keeps a product promotable when the parent is on clearance & out of stock.
Category exclusion
Any product in the selected category is omitted from the feed (or becomes Discontinued).

Enable both sync options above to make Nosto match the default Shopware storefront behaviour.

6 Display Scenarios & Resulting Nosto Status
6.1 Simple Product (no variants)
Stock 0 & both clearance sale and hide after clearance flags are On
Hidden
Discontinued
Stock 0 & Clearance sale On only
Visible, can’t buy
OutOfStock
Stock ≥ 1
Visible, purchasable
InStock
6.2 Variant Product — Display parent mode
Parent OOS, both clearance sale and hide after clearance flags On
First available variant shown
Variant InStock
Parent OOS, Clearance sale flag On
Parent shown (can’t buy)
Parent OutOfStock
Parent inactive, variant active
Variant shown
Variant InStock/OutOfStock (depending on availability)

6.3 Variant Product — Display cheapest mode
OOS + both clearance sale and hide after clearance flags On
Discontinued
OOS + Clearance sale On
OutOfStock
Cheapest inactive
Next active variant syncs (status depends on stock)

6.4 Variant Product — Choose a variant mode
Selected variant OOS + both clearance sale and hide after clearance flags On
First available variant shown
Variant InStock
Selected variant OOS + Clearance sale On
Variant shown (can’t buy)
OutOfStock
Selected variant inactive
First active variant shows
InStock/OutOfStock (depending on availability)

6.5 Expanded Property Listings
No property selected
Clearance sale On only
First active variant per product
InStock/OutOfStock (depending on availability)
Both clearance sale and hide after clearance flags On
First available variant
InStock

All properties selected
Every active variant is listed; Nosto mirrors availability per variant.
With Both clearance sale and hide after clearance flags On, only available variants appear and sync as InStock.

Sub-set of properties
One variant per selected property value.
With Both clearance sale and hide after clearance flags On, only available variants appear and sync as InStock.

Last updated
Was this helpful?