> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/supra-shopify-theme/supra/pages-and-templates.md).

# Pages & Templates

What each Shopify template looks like in SUPRA, and which ones need a page.

## Templates that work on their own

| Template           | What it is                                                          |
| ------------------ | ------------------------------------------------------------------- |
| `index`            | Home page — filmstrip, featured collection, Enter Page over the top |
| `collection`       | The one-screen grid with the category rail                          |
| `product`          | Image, details, colourway thumbnails                                |
| `cart`             | The dotted-border cart table                                        |
| `search`           | Predictive search plus the results grid                             |
| `blog` / `article` | Blog list and post                                                  |
| `list-collections` | All collections                                                     |
| `404`              | Not found                                                           |
| `password`         | The closed-store page                                               |

## Templates that need a page assigned

These do nothing until a page uses them. Create the page in **Online Store → Pages**, then pick the template under **Theme template** on the right.

| Template        | Create a page called                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `page.faq`      | FAQ                                                                                                                                  |
| `page.lookbook` | Lookbook                                                                                                                             |
| `page.contact`  | Contact                                                                                                                              |
| `page.preview`  | Preview — the crops that open the [Preview](https://github.com/cec-hdz/webexp-docs/tree/main/supra/sections-and-features/preview.md) |
| `page.policies` | Policies — see [Policies](https://github.com/cec-hdz/webexp-docs/tree/main/supra/sections-and-features/policies.md)                  |
| `page.random`   | Random                                                                                                                               |

## Two templates you should not assign

You will see `page.preview-all` sitting in the template dropdown next to `preview`, looking like a second page you are supposed to create. **Leave it alone.**

| Template           | What it is                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------- |
| `page.preview-all` | The preview set as a grid. An alternate view of the Preview page — no second page to create |
| `product.preview`  | One item, stepped through. An alternate view of the product                                 |

Both exist as files because that is what makes the link work: Shopify resolves `?view=preview-all` by looking for a template of that name, and Liquid cannot read a query parameter, so a second file is the only way to give one page two layouts.

Shopify lists every template file in that dropdown and gives a theme no way to mark one as internal, which is why they are visible at all. Assigning one to a page is harmless — you just get the same grid at a second address that nothing links to.

See [Preview](https://github.com/cec-hdz/webexp-docs/tree/main/supra/sections-and-features/preview.md) for how the three views fit together.

## Why an unassigned template previews the wrong content

Open one in the theme editor before a page uses it and you'll see the panel say **"Assigned to 0 pages"** with some unrelated page underneath — often an auto-generated one like "Your Privacy Choices".

That's Shopify. With no real page to preview the template against, it falls back to whatever page it can find. Assign a page and the preview corrects itself. Customers never see it — an unassigned template isn't reachable on your storefront.

## Customer account templates

Login, register, account, addresses, order and password reset are all included and styled. See [Customer Accounts](/supra-shopify-theme/supra/customer-accounts.md).