Vale (Theme documentation)

(Sections · Commerce)

Commerce and templates

Shoppable sections, plus the sections that make up the header, footer, cart, search and journal templates.

Product spotlight

02 · product-spotlight
Add section
Screenshot of the Product spotlight section in the Vale preset.
Product spotlight, as it looks in the Vale preset.

One product, full bleed: its featured photograph or video (or your own image or video) under a soft veil, with the eyebrow, title, a short text, detail lines, price and buy buttons placed in one of nine positions. Add to cart uses the real product form and opens the cart drawer; quick add opens the product in a window. Both preset home pages include it, after the editorial letter. Presets: Product spotlight, Product spotlight: video and Product spotlight: framed.

Tip: Pick the product first: until then the editor shows an example. A product video in first position plays as a silent loop when the picture is set to the product's featured media.

Key settings

  • Product
  • PictureProduct's featured media · Custom image · Custom video
  • Image
  • Shopify-hosted video
  • Play video on phones
  • HeightFull screen · Large · Medium
  • Full width
  • Content positionTop left · Top center · Top right · Middle left · Middle center · Middle right · Bottom left · Bottom center · Bottom right
  • Heading levelH1 (page title) · H2
  • VeilGradient toward the text · Even tint · None
  • Image overlay
  • Scroll effectPicture settles from a slight zoom · Words rise into place · None
Blocks (6)
Eyebrow
Eyebrow label, When empty, show (vendor or product type), Show bronze dot
Heading
Heading (empty uses the product title), Heading size, Font, Link to the product
Text
Text, Use the product description, Words shown
Detail line
Label, Value
Price
Show sale and sold-out badges
Buy buttons
Button (Add to cart · Quick add · View product), Show variant picker, Show dynamic checkout buttons, Show a link to the product, Link label

Product story

03 · product-story-split
Add section
Screenshot of the Product story section in the Vale preset.
Product story, as it looks in the Vale preset.

One product told as a short story: a tall lifestyle plate (sticky on desktop) beside eyebrow, heading, text, quote, spec rows and the buy form.

Key settings

  • Product
  • Lifestyle image
  • Image shapePortrait 4:5 · Portrait 3:4 · Tall 2:3 · Square · Landscape 4:3
  • Show product card on the image
  • Image positionLeft · Right
Blocks (7)
Eyebrow
Eyebrow label
Heading
Heading, Heading size
Text
Text, Larger text
Quote
Quote, Author
Spec row
Label, Value
Buy
Purchase, Show quantity, Product page link label
Custom Liquid
Custom Liquid

Shop the look

04 · shop-the-look
Add section
Screenshot of the Shop the look section in the Vale preset.
Shop the look, as it looks in the Vale preset.

A room image with numbered hotspots; each opens a small product card with quick add, or a short note with a link. The same products are listed beside or under the image, so nothing depends on the hotspots. The Image hotspots preset starts with notes instead of products.

Tip: Keyboard: Tab to a pin, Enter or Space opens it, Escape closes it, arrow keys move between pins.

Key settings

  • Product card color scheme
  • Image
  • Image shapeNatural · Portrait 4:5 · Square · Landscape 4:3 · Landscape 3:2 · Wide 16:9
  • Eyebrow label
  • Heading
  • Heading sizeLarge · Medium · Small · Serif display
  • Text
  • Button label
  • Link
  • LayoutImage beside the list · Wide image, list below
  • Image positionLeft · Right
  • Show the product list
  • Show quick add
Blocks (2)
Product hotspot
Product, Horizontal position, Vertical position
Hotspot with note
Heading, Text, Link label, Link, Horizontal position, Vertical position

Related products

05 · product-recommendations
Add section
Screenshot of the Related products section in the Vale preset.
Related products, as it looks in the Vale preset.

Related products loaded from Shopify's recommendations, as a grid or carousel. It hides itself when Shopify has nothing to recommend.

Key settings

  • Eyebrow label
  • Heading
  • Maximum products
  • Columns on desktop
  • LayoutGrid · Carousel
  • Enable quick add

Recently viewed

06 · recently-viewed
Add section
Screenshot of the Recently viewed section in the Vale preset.
Recently viewed, as it looks in the Vale preset.

The products this visitor opened most recently, newest first, as the theme's product cards. The product on screen is left out, and the section stays hidden until there is something to show. The history is kept in the visitor's own browser. The default and story product templates include it.

Tip: In the theme editor it shows placeholder cards, so you can place and style it before any history exists.

Key settings

  • Eyebrow label
  • Heading
  • Heading sizeLarge · Medium · Small · Serif display
  • Maximum products
  • Show quick add
  • Show color swatches
  • Show "Clear history" link
  • Columns on desktop
  • Top spacingNone · Small · Regular
  • Bottom spacingNone · Small · Regular

Cart drawer

09 · cart-drawer
Template / group section
The cart drawer after adding a piece. Numbered labels mark the parts described below.
The cart drawer after adding a piece.
  1. 01Line item
  2. 02Quantity
  3. 03Order note
  4. 04Subtotal and taxes
  5. 05Checkout

The slide-out cart: line items, quantity, discounts, an optional free-shipping progress line, recommendations and dynamic checkout buttons. Choose drawer or page in Theme settings > Cart.

Key settings

  • Free shipping threshold
  • Show dynamic checkout buttons
  • Show product recommendations
  • Heading
  • Recommendation typeRelated · Complementary
  • Maximum products

Cart items

10 · main-cart-items
Template / group section
Screenshot of the Cart items section in the Vale preset.
Cart items, as it looks in the Vale preset.

The cart page items. Works without JavaScript; with it, quantities update in place.

Key settings

  • Eyebrow label

Blog

13 · main-blog
Template / group section
Screenshot of the Blog section in the Vale preset.
Blog, as it looks in the Vale preset.

The journal index: topic filter from blog tags, journal search, the latest article large, then a grid or an index list.

Key settings

  • Eyebrow label
  • Introduction
  • Show topic filter (blog tags)
  • Show journal search
  • LayoutGrid · Index list
  • Feature the latest article
  • Columns on desktop
  • Image ratioLandscape (3:2) · Wide (16:9) · Square · Portrait (4:5)
  • Articles per page
  • Show image
  • Show excerpt
  • Show date
  • Show reading time
  • Show author
  • Add structured data for search engines

Article

14 · main-article
Template / group section
Screenshot of the Article section in the Vale preset.
Article, as it looks in the Vale preset.

The article: every part is a block (title and details, featured image, content, pull quote, share, tags, author, comments, related articles). Content supports a drop cap, pull quotes and captions from image alt text.

Key settings

  • LayoutEditorial (offset column) · Centered
  • Add article structured data for search engines
Blocks (9)
Title and details
Show topic, Title size, Show date, Show reading time, Show author, Show comment count
Featured image
Width, Image ratio, Show caption
Content
Show excerpt as a standfirst, Drop cap on the first paragraph, Larger first paragraph, Caption images with their alt text, Text size
Pull quote
Quote, Attribution
Share
X (Twitter), Facebook, Pinterest, Email
Tags
No settings
Author
Show picture, Show bio
Comments
No settings
Related articles
Heading, Number of articles, Prefer articles with the same tags

Compare

15 · compare-products
Add sectionNew
Screenshot of the Compare section in the Vale preset.
Compare, as it looks in the Vale preset.

Shows the 2 to 4 pieces a shopper chose to compare, side by side: photo, price, availability and every specification metafield, with an Only show differences switch. Use it on a page with the page.compare template and pick that page in Theme settings › Product cards › Shopping tools.

Tip: Rows come from product metafields in the specs namespace (or the one you set), the same ones the product page specification table reads. See Shopping tools.

Key settings

  • Eyebrow label
  • Heading
  • Text
  • Message when empty
  • Link when empty
  • Color scheme
  • Top spacingNone · Small · Regular
  • Bottom spacingNone · Small · Regular

Saved pieces

16 · saved-products
Add sectionNew
Screenshot of the Saved pieces section in the Vale preset.
Saved pieces, as it looks in the Vale preset.

The pieces a shopper saved with the heart, kept in their browser, with Quick add, Remove and Clear. Use it on a page with the page.wishlist template and pick that page in Theme settings › Product cards › Shopping tools.

Tip: The header shows a link with the count once something is saved. See Shopping tools.

Key settings

  • Eyebrow label
  • Heading
  • Text
  • Message when empty
  • Link when empty
  • Columns on desktop
  • Color scheme
  • Top spacingNone · Small · Regular
  • Bottom spacingNone · Small · Regular

Quick order list

17 · quick-order-list
Add sectionNew
Screenshot of the Quick order list section in the Vale preset.
Quick order list, as it looks in the Vale preset.

A product’s variants as an order table for trade and wholesale buyers: SKU, price with quantity breaks, stock, a quantity per row, a live total and one Add to cart for every line. The same table is available as a product page block.

Tip: Quantity rules and price breaks from B2B catalogs are applied automatically. See Shopping tools.

Key settings

  • Product
  • Eyebrow label
  • Heading
  • Text
  • Rows before Show more
  • Show SKU
  • Show stock
  • Color scheme
  • Top spacingNone · Small · Regular
  • Bottom spacingNone · Small · Regular

Shoppable video

18 · shoppable-video
Add sectionNew
Screenshot of the Shoppable video section in the Vale preset.
Shoppable video, as it looks in the Vale preset.

Vertical clips in a row, each tagged with up to three products that open quick add or quick view. Clips play muted only while on screen, never with reduced motion, and each has a pause control.

Tip: Upload 9:16 clips of 10 to 30 seconds in Content › Files. The screenshot shows each clip’s cover image.

Key settings

  • Eyebrow label
  • Heading
  • Heading sizeLarge · Medium · Small · Serif display
  • Text
  • Clips per row on desktop
  • Color scheme
  • Top spacingNone · Small · Regular
  • Bottom spacingNone · Small · Regular

Blocks

  • Clip