Replacement modes

The replacement mode decides, for each page kind, whether the plugin is even allowed to consider an alternative layout for a given base. Modes are configured per sales channel in Settings → Extensions → Advanced Layouts Assigner → Replacement mode.

Three page kinds have independent mode settings: Product page, Category page, Landing page.

Product page

Mode	When the plugin tries to replace
Without assigned layout (default)	Only when the product has no specific CMS layout (Shopware would use the default product page layout).
Assigned to replaceable layouts	Only when the product’s layout is in the Replaceable layouts for product pages allow-list.
Without assigned layout or assigned to replaceable layouts	Either of the two above.
All	Always — any layout assigned to the product is eligible for replacement when a rule matches.

Tip

Use Without assigned layout if you want to keep editorial control: products with a hand-picked layout are left alone, and the plugin only steps in for everything else.

Category page

Mode	When the plugin tries to replace
With default layout (default)	Only when the category’s layout is Shopware’s configured default layout for categories (set in Settings → Shopping Experiences → Default layouts).
Assigned to replaceable layouts	Only when the category’s layout is in the Replaceable layouts for category pages allow-list.
All	Always — any layout assigned to the category is eligible for replacement when a rule matches.

Caution

With default layout is the most conservative — and the most surprising. Per-category bespoke layouts are not touched. If you assigned a custom layout to one category and a rule for that channel should still replace it, switch to All or add that bespoke layout to the Replaceable layouts allow-list.

Landing page

Mode	When the plugin tries to replace
With default layout (default)	Only when the landing page is using the Default landing page layout that you configure under the Landing page card (see Default landing page layout).
Assigned to replaceable layouts	Only when the landing page’s layout is in the Replaceable layouts for landing pages allow-list.
All	Always — any layout assigned to the landing page is eligible for replacement when a rule matches.

Caution

Shopware does not allow a landing page to exist without a layout assignment, so there is no “Without assigned layout” mode. If you want the plugin to act on landing pages that didn’t originally have a layout, set the Default landing page layout in the Landing page card — the plugin uses it as the implicit base.

Choosing a mode

The defaults seeded at install time are conservative — they minimise unexpected behaviour but require explicit opt-in for many setups. The most common reconfigurations:

• Two sales channels, same category tree, different layouts everywhere → set everything to All. See the multi-sales-channel recipe.
• Multi-channel but only some layouts should be replaceable → set everything to Assigned to replaceable layouts and list the eligible bases. Useful when one shared layout (e.g. an “evergreen” product page) must never change.
• Default category layout shared across all categories, per-category overrides should win → keep With default layout. Per-category overrides are skipped.

Per-sales-channel scope

The replacement mode is a per-sales-channel setting. Switch sales channels at the top of the configuration form and pick a different mode per channel. Use the All sales channels scope for shared defaults; per-channel overrides take precedence.

Related

• Replacement types — even when a base is eligible, the alternative type must be allowed.
• Custom rule conditions — the matching layer.
• Multi-sales-channel recipe — the canonical setup.