Per-Product Detail Page

Where to find: Product edit screen → Custom page for this product card → Design custom page (opens the editor locked to that product) Who it's for: Anyone who wants to design a distinct, dedicated detail page for a specific product (for example a flagship product or a campaign bundle) In short: The product detail template is normally single/global for all products. This feature lets you assign a single product its own layout; that product is shown with its custom template while every other product keeps the global layout.

---

What is it for?

The block-based layout you build with the Product Page Template (Block-Based Product Page) applies to every product in your store. That is enough for most stores, but sometimes you want to highlight one product:

• A special presentation for a campaign or story-driven product,
• A richer, differently ordered page for a "flagship" product,
• Custom blocks used only on that one product.

The per-product detail page does exactly that: an independent product page layout that affects only that one product.

How it works (resolution order)

When a customer opens a product page, the system decides in this order:

1. Does this product have a published custom page with at least one block in it? → If so, it is used.
2. Otherwise the global Product Page Template (for all products) is used.
3. If there is none either, the default layout installed for the store is used. (The product page is block-based in every store; there is no classic/manual layout any more.)

So a custom page only takes effect once it is published and only for that product. Editing the global template does not affect products with a custom page; removing the custom page automatically returns the product to the global Product Page template.

If you delete every block of the custom page and publish it, that product falls back to the global Product Page Template. (A completely empty template cannot be published anyway, because of the required-block rule.) The clean way to return the product to the global template is to remove the custom page.

Designing a custom page

1. Open the product under Catalog → Products (or create a new product and save it — the product must be saved before it can have a custom page).
2. In the Custom page for this product card at the bottom of the form, click Design custom page.
3. The theme editor opens locked to that product:
   • The top bar shows the product name and a Custom page badge.
   • The preview always uses that product; the preview-product picker is hidden (the product is fixed).
   • The page selector is hidden; you only edit this product's page.
4. On first open, the custom page starts as a copy of the global Product Page Template. If the global template does not exist yet, it is created first — the custom page never starts empty; it always arrives filled with the default layout.
5. Arrange blocks on the Canvas and Preview, style them from the Properties Panel (Right Panel) and click Publish. Until it is published, customers keep seeing the global template.

Required blocks apply here too. If any of product images, product title, price, variant selector or add to cart is missing, the custom page cannot be published; the toolbar badge names the gaps and the Publish dialog offers an "Add missing blocks" shortcut. See Product Page Template (Block-Based Product Page).

Editing product content from the editor

In the locked editor, selecting a product identity block shows a dashed Product content card at the top of the properties panel. From there you can change the product's own data without leaving the editor:

The card is visually separate from the block settings: dashed border, package icon and a No publish needed badge. The tabs below it (Content, Appearance, Layout…) are the block's settings as usual; the card is the product's own data.

Important — these fields do not wait in a draft. In the theme editor your block changes pile up in a draft and only go live when you press Publish. Product data has no such draft: the moment you press Save to product the product is updated and appears on the storefront within a minute — even if your theme draft is still unpublished. The card states this with its badge and description line.

Saving and undo

• Until you change the value, the Save to product button stays disabled; nothing is written by accident.
• After saving, an Undo button appears on the card, which writes the pre-edit value back. It disappears when you leave the page; to see the old value later, check Settings → Activity log — every change made from the editor is recorded there with a "was: …" note.
• If the same product was changed in another tab or in the catalog form, the save is rejected and a dialog shows you the current value. You cannot silently overwrite what someone else wrote.

Where it is not editable

• Not on the global Product Page Template. The product previewed there is just an arbitrary one picked for design work; the card says so and offers an Open this product's own page shortcut.
• Not on the built-in sample products. Those are representative records the system generates for preview; there is no real product behind them.
• The card only appears for users with product write permission. A user with theme permission alone can neither see nor edit these fields.

Not in this card: price, stock, long description, images, brand, category and URL (slug). Use the product form under Catalog → Products for those; the Back to product button in the top bar takes you straight there.

Back to product and removing the custom page

In the locked editor's top bar:

• Back to product — Leaves without saving and returns to the product edit screen.
• Remove custom page — After confirmation, deletes this product's custom page; the product returns to the global template. You can do the same from the Custom page for this product card on the product form.

Limit

Custom pages are meant for a handful of highlighted products. There is a reasonable upper limit on how many custom product pages a store can create; when you reach it, trying to create a new one shows a warning. Editing an existing custom page is always possible.

Tips

• In the locked editor, Publish publishes only that product's custom page. Pending drafts on other pages (home page, header/footer structure) and a pending theme-settings draft are not published; publish those from the regular theme editor.
• While the custom page is a draft (not yet published), the product is still shown with the global template. Click Publish to take your changes live.
• Changes to the global Product Page Template do not affect products that have a custom page. To update those too, edit each product's custom page separately.
• Features such as conditional block visibility, section dividers and entry animations work on the custom page just the same.