How to target specific pages

By default a popup appears on every page. This guide shows how to restrict a popup to specific pages, URLs, or categories — and how to limit it to specific sales channels.

---

Sales channel scoping

In the Conditions section of the popup editor, open the Sales Channels field and select one or more sales channels.

• When one or more sales channels are selected, the popup shows only on those channels.
• When the field is left empty, the popup shows on all sales channels.

---

Targeting Mode

Set Targeting Mode to control which pages the popup appears on.

Mode	Behavior
(none / empty)	Popup appears on every page of every matching sales channel.
Page Restriction	Popup appears only on the named Shopware routes you select.
Custom URL	Popup appears only on paths that match your URL patterns.

---

Page Restriction mode

Select Page Restriction in the Targeting Mode field. A Page Restriction multi-select appears.

Choose from:

Option	Storefront route
Home Page	/
Cart Page	/checkout/cart
Checkout Confirm	/checkout/confirm
Checkout Finish	/checkout/finish
Login Page	/account/login
Product Detail	Any product detail page
Category/Listing	Any category or listing page

You can select multiple routes. The popup appears on any page that matches at least one of the selected routes.

Category restriction

When Category/Listing is included in the Page Restriction list, an additional Category Restriction tag-select appears. Pick specific categories to limit the popup further.

• If no categories are selected, the popup shows on all category and listing pages.
• If one or more categories are selected, the popup shows only when the visitor is on one of those categories.

Product restriction

When Product Detail is included in the Page Restriction list, an additional Product Restriction multi-select appears. Pick specific products — variants are individually selectable — to limit the popup further.

• If no products are selected, the popup shows on all product detail pages.
• If one or more products are selected, the popup shows only on those products' detail pages. A variant's page carries the variant's own id, so a popup pinned to a specific variant fires only there.

---

Custom URL mode

Select Custom URL in the Targeting Mode field. A Custom URLs tag input appears.

Type a relative URL path and press Enter (or Tab) to add it as an option, then select it. You can add multiple patterns.

Supported pattern syntax:

Pattern	Matches
/landing/summer-sale	Exactly that path
/landing/*	Any path starting with /landing/
/detail/*	Any product detail URL

Rules:

• Paths are relative to the sales-channel base URL.
• Patterns are case-insensitive.
• The trailing slash is optional — /landing/summer-sale and /landing/summer-sale/ both match.
• Query strings are ignored. /search?query=shoes matches a pattern of /search.
• A * wildcard matches any sequence of characters in that position.

---

Combining sales channel, targeting mode, and rules

All three conditions are applied together:

1. Sales Channel must match (or be empty).
2. Targeting Mode (page/URL restriction) must match (or be empty).
3. Trigger Rules (Shopware Rule Builder) must all match (or be empty).

A popup only appears when every condition that has been set is satisfied.

---

Examples

Goal	Configuration
Show on home page only	Targeting Mode: Page Restriction → Home Page
Show on all product pages	Targeting Mode: Page Restriction → Product Detail
Show on one product's detail page	Targeting Mode: Page Restriction → Product Detail, Product Restriction: the product
Show on one landing page	Targeting Mode: Custom URL → /landing/summer-sale
Show on all landing pages	Targeting Mode: Custom URL → /landing/*
Show on Summer Sale category	Targeting Mode: Page Restriction → Category/Listing, Category Restriction: Summer Sale
Show only on German sales channel	Sales Channels: German Storefront
Show to logged-in customers only	Rules: Customer is logged in (Shopware rule)