Replacement types
The Replacement types card on the plugin’s settings page controls what kinds of CMS layouts can act as alternatives for each incoming page kind. It is the second gate the plugin checks after the replacement mode — if it’s empty for a given page kind, the plugin will not look up any alternative for that kind at all, even if rules match.
The matrix
Section titled “The matrix”| Incoming page | Default replacement types (seeded at install) | Other allowed values |
|---|---|---|
| Product page | Product page (product_detail) | Shop page, Landing page, Listing page |
| Shop page | Shop page (page) | Landing page, Listing page |
| Landing page | Landing page (landingpage) | Shop page, Listing page |
| Listing page | Listing page (product_list) | Shop page, Landing page |
Read each row as: “When the visitor lands on a {incoming page}, the plugin may swap it for a CMS layout of one of these types.”
The “incoming page” is the type of the base layout, not necessarily the URL. So a category configured with a landingpage-type layout falls under Landing page for the type check.
Why widen the list?
Section titled “Why widen the list?”The defaults pair each kind with its own type — a product page is replaced by another product layout, a listing by another listing. That’s almost always the right starting point.
Widen the list when:
- You want a listing category to render as a fully bespoke landing page layout on one sales channel — add
landingpageto Listing page. - You want a product page to use a shop page layout for a marketing push — add
pageto Product page. - You want the same
pagelayout to act as both a shop page and a landing page replacement — addpageto Landing page too.
Empty list = plugin off for that kind
Section titled “Empty list = plugin off for that kind”If a row is empty, the plugin short-circuits: it will not look up any alternative layout for that incoming page kind, regardless of rules. This is the easiest way to disable replacement for one page kind without touching the mode.
For example, to stop replacing product pages entirely (but keep replacing categories), clear the Product page row.
Per-sales-channel scope
Section titled “Per-sales-channel scope”Like every setting in this plugin, Replacement types are stored per sales channel. Use the sales channel switcher at the top of the form to maintain different lists per channel, falling back to All sales channels for shared defaults.
Related
Section titled “Related”- Replacement modes — the first gate.
- Custom rule conditions — what decides which alternative wins.
- Page-type matrix — the same table, with internal type names.