Skip to content
P2Lab Advanced Layouts Assigner

Homepage-only override

A narrow but common ask: keep all category and product layouts as-is, but swap just the homepage under some condition (a new sales channel, a campaign, a specific date range).

Setup

Section titled “Setup”
  1. Settings → Rules → Create new rule — name: Homepage swap. Add an AND container with:
    • Is homepage [P2Lab Layouts Assigner] = Yes (added by this plugin)
    • …plus whatever additional conditions you need (Sales Channel, Date range, Customer group, etc.).
    • Save.
  2. Content → Shopping Experiences — build the alternative homepage layout (type Landing page, Shop page, or Listing page, whichever matches your base homepage).
  3. Layout assignment → Rules tab → assign Homepage swap. Save.
  4. Settings → Extensions → Advanced Layouts Assigner:
    • Category page replacement mode → All (or Assigned to replaceable layouts with the homepage base in the allow-list, if you want tight control).
    • Replacement types → make sure the alternative’s type is listed in the row for the base’s type.

What Is homepage actually checks

Section titled “What Is homepage actually checks”

The Is homepage condition is true only when the visitor’s request resolves to the navigation root of the active sales channel (i.e. categoryId === salesChannel.navigationCategoryId). It is not true on subcategories, not on landing pages, not on product pages.

That makes it the right tool for exactly this recipe — and the wrong tool when you want a rule to also cover listings and product pages. See the multi-sales-channel pitfall for the most common misuse.

Why not just assign the homepage layout directly to the root category?

Section titled “Why not just assign the homepage layout directly to the root category?”

You can — and if you only have one homepage, that’s the right answer (no plugin needed). The plugin is the right tool when you need the homepage layout to vary by sales channel, date, customer, etc. without losing the ability to keep one root category that all channels share.

Section titled “Related”