Skip to content

Page positions

Four of the configuration tabs — Product Page, Shopping Cart, Checkout, Checkout Register — share the same basic shape: a Placement position drop-down that picks where the widget is rendered, plus optional context-specific overrides.

Each context can be independently turned off by selecting Disabled in its placement drop-down.

Placement optionWhere the widget appears
disabledDon’t render the widget on product pages
belowAddToCardJust under the “Add to cart” button (default placement)
aboveAddToCardAbove the “Add to cart” button
besidePriceInline next to the product price

The Product Page tab is the only one with out-of-stock visibility overrides. Each widget part can be independently hidden when the product is out of stock:

FieldOptions
clockHideOutOfStockdisabled (don’t hide) / closeoutOnly (hide for clearance products) / allProducts (hide for any out-of-stock product)
stepsHideOutOfStockSame three options
messageHideOutOfStockSame three options

The clearance sale option targets Shopware’s clearance / closeout flag — useful for keeping the urgency clock visible on regular out-of-stock products (where you might restock) but hiding it on items you no longer plan to sell.

Placement optionWhere the widget appears
disabledDon’t render
belowProductListTableBelow the line-item table
aboveProductListTableAbove the line-item table

The widest set of placement options, because the checkout page has more anchor points:

Placement optionWhere the widget appears
disabledDon’t render
atTopOfPageAbove everything, full-page-wide
atTopPageContainerInside the page container, above the rest
aboveHeaderAbove the “Order summary” header
belowHeaderBelow the “Order summary” header
aboveProductListTableAbove the order line-items

The account / register page (/account/register and the inline guest register on checkout):

Placement optionWhere the widget appears
disabledDon’t render
atTopOfPageAbove everything
aboveHeaderAbove the page header
belowHeaderBelow the page header

A few heuristics:

  • Product detail: belowAddToCard is the default for a reason — the customer’s eye is already on the buy button. besidePrice is good for stores where the price is the focal point.
  • Cart: aboveProductListTable works well as a reassurance line right where the totals are computed.
  • Checkout confirm: belowHeader puts the widget under the “Complete order” page title.
  • Register: belowHeader to highlight delivery as a reason to create an account.

If none of the placement options fit your theme, every widget render goes through a Twig include block — you can extend it from a theme override. See Storefront → Template blocks.