Skip to content
P2Lab Advanced Layouts Assigner

Settings reference

A complete reference to Settings → Extensions → Advanced Layouts Assigner, in the order the cards appear.

All settings are stored per sales channel — pick the active scope at the top of the form. The All sales channels scope acts as a fallback when a per-channel value is unset.

Card 1: Welcome

Section titled “Card 1: Welcome”

Static introduction text. No fields.

Card 2: Replacement mode

Section titled “Card 2: Replacement mode”

The first gate per page kind. See Replacement modes for the full discussion.

Product page

Section titled “Product page”
  • Replacement mode — single-select.
    • Without assigned layout (default) — replace only when the product has no specific layout.
    • Assigned to replaceable layouts — replace only when the product’s layout is in the allow-list below.
    • Without assigned layout or assigned to replaceable layouts — either of the two above.
    • All — always eligible.
  • Replaceable layouts for product pages — multi-select of product_detail CMS pages. Only consulted when the mode is one of the two replacementCmsPages variants.

Category page

Section titled “Category page”
  • Replacement mode — single-select.
    • With default layout (default) — replace only when the category’s layout is Shopware’s configured default category layout.
    • Assigned to replaceable layouts — replace only when the category’s layout is in the allow-list below.
    • All — always eligible.
  • Replaceable layouts for category pages — multi-select of page, landingpage or product_list CMS pages.

Landing page

Section titled “Landing page”
  • Replacement mode — single-select.
    • With default layout (default) — replace only when the landing page is using the default set in Card 3.
    • Assigned to replaceable layouts — replace only when the layout is in the allow-list below.
    • All — always eligible.
  • Replaceable layouts for landing pages — multi-select of landingpage CMS pages.

Card 3: Landing page

Section titled “Card 3: Landing page”
  • Default landing page layout — single CMS page picker of type landingpage. Used when a landing page has no layout of its own. See Default landing page layout.

Card 4: Replacement types

Section titled “Card 4: Replacement types”

The second gate per page kind. See Replacement types for guidance.

For each “incoming” page kind, pick the CMS page types that may act as alternatives. An empty list disables replacement for that incoming kind regardless of the mode.

  • Product page — defaults to Product page (product_detail).
  • Shop page — defaults to Shop page (page).
  • Landing page — defaults to Landing page (landingpage).
  • Listing page — defaults to Listing page (product_list).

Each multi-select accepts any subset of product_detail, page, landingpage, product_list (subject to a couple of natural exclusions in the admin form — Listing page replacements cannot themselves be Product Detail pages, for example).

Per-sales-channel scope

Section titled “Per-sales-channel scope”

Every field above is per sales channel. The form is keyed off the sales channel switcher at the top. The All sales channels scope is the fallback — per-channel values override it.

Section titled “Related”