Product Page — Default PDP
The standard product detail page, where the shopper picks a variant and adds it to the cart.
Overview
| Item | Detail |
|---|---|
| Template | templates/product.json |
| URL | /products/{handle} |
| Main section | sections/main-product.liquid |
| Layout | theme.liquid + Global UI |
Sections (order)
- main-product — gallery + form + tabs
- product-recommendations — related products
- recently-viewed — recently viewed products
- collection-return — (may be disabled)
- testimonials
- slideshow
- product-full-width — (may be disabled)
- apps — (may be disabled)
Main product blocks (default order)
Typical order on the default product template (templates/product.json):
- Price
- Countdown timer
- Separator
- Variant picker (buttons + colour image cards)
- Quantity selector
- Size chart (after quantity)
- Inventory status
- Buy buttons
- Description (collapsible / tabs)
- Related Products (product metafield
custom.related_products)
Other block types (sales points, trust badge, share, tabs, contact, custom HTML, complementary products, etc.) can be added in the Theme Editor.
Step-by-step user journey
Step 1 — Open the product
- Arrive from a collection, search, the homepage or a direct URL
- Breadcrumbs lead back to the collection or home
Step 2 — Browse the media gallery
- View the main image or video
- Switch media using the thumbnails (beside the gallery on desktop)
- Enlarge with zoom / lightbox (Photoswipe)
- On mobile, a full-width swipe gallery
Step 3 — Read the product info
- Check the title and price
- Read the short description
- Scan the sales points (e.g. Organic cotton)
Step 4 — Select variants
- Select a colour (image card or colour swatch). On mobile, colour image cards are centered.
- Select size and any other option buttons
- Dynamic variants: unavailable options are disabled or hidden
- The price and image may update when the variant changes
Step 5 — Size chart (optional)
- If the product is not in a Hide size chart collection, a Size chart link appears after quantity (or beside Size when connected to the size option).
- Click Size chart
- A white modal opens:
- Product-specific: image from metafield
custom.products_size_chart - Otherwise: content from the block’s Size chart page
- Product-specific: image from metafield
- Optional zoom (+/−, pinch, double-tap) then close with X
Size chart is hidden for products in any Theme Editor collection list under Hide size chart collections (e.g. Unstitched).
Step 6 — Quantity and Add to cart
- Set the quantity (if the quantity selector is on)
- Press Add to cart
- The cart drawer opens (in drawer mode)
- Continue to checkout or carry on shopping
Step 7 — Product details
- Open Details & Description (collapsible default) or tabs for full description and extra content
Step 8 — Discover more
- Scroll to Related Products (metafield-driven) and/or Product recommendations
- Check the Recently viewed products
- Testimonials and slideshow content (if enabled)
Key settings (Theme Editor)
| Setting / block | Purpose |
|---|---|
| Image zoom | Gallery zoom on/off |
| Thumbnail position | Beside / below |
| Colour swatches + image cards | Variant colour UI |
| Dynamic variants | Hide invalid combinations |
| Size chart → Size chart page | Default chart for products without a metafield image |
| Size chart → Hide size chart collections | Multi-select collections that never show size chart |
| Dynamic checkout | Buy Now / wallets |
| Surface pickup | Store availability |
| Gift card recipient | Recipient form on gift products |
Full Size chart rules and metafield setup: main-product — Size chart.
<!-- BEGIN GENERATED: theme-editor -->
Theme Editor settings
Each section below links to its full settings reference — every setting with id, type, default and a screenshot of the panel.
| Section | Type | Settings | Blocks |
|---|---|---|---|
| Back to collection | collection-return | 0 | 0 |
| Product | main-product | 12 | 18 |
| Full-width details | product-full-width | 2 | 8 |
| Related products | product-recommendations | 14 | 0 |
| Recently viewed | recently-viewed | 13 | 0 |
Full index: settings reference
<!-- END GENERATED: theme-editor -->Related files
templates/product.json
sections/main-product.liquid
sections/product-recommendations.liquid
sections/recently-viewed.liquid
snippets/product-images.liquid
snippets/product-form.liquid
snippets/form.product.liquid
snippets/product-template.liquid
snippets/product-size-chart-content.liquid
snippets/variant-button.liquid
snippets/quantity-input.liquid
snippets/tab.liquid
assets/theme.js
assets/theme.css.liquid