Documentation
Section reference
Every section Vestige ships with, what it's for, and its settings.
← Back to docsContent sections
These are the flexible, drag-and-drop sections for building out pages — add them from Add section in the theme editor, on any template that supports sections (the home page, and any page using a JSON template). Drag to reorder, and most have their own top/bottom padding controls so spacing between sections stays consistent.
Slideshow
Full-width rotating hero banner for the top of any page — image or video slides with animated text overlay, autoplay, and swipe/arrow navigation.
- Height — Small / Medium / Full height
- Autoplay seconds (0 = off)
- Arrow & pause button icon color and background
- Heading size
- Per slide (up to 5): image or video URL (video takes priority if both are set), overlay opacity, eyebrow, heading, subheading, text color, button text + link
Autoplay automatically pauses a slide's video when it's not the active slide, and the whole slideshow respects visitors' reduced-motion preference.
Promo banner
Single full-bleed image banner with a heading, text, and button — good for a seasonal callout or a shipping/promo message.
- Background image, overlay opacity, ratio (Ultra-wide / Wide / Panoramic)
- Eyebrow, heading (+ size and tag), text
- Button text + link
- Section padding
Promo tiles
A row of image tiles, each linking somewhere — for showcasing categories or curated edits side by side.
- Per tile (add as many as you like): image, eyebrow, heading, description, link, ratio (Portrait / Square / Landscape)
- Also supports a Custom Liquid block
- Section padding
Multicolumn
Numbered, step-style columns for explaining a process — how you source materials, make products, ship, and so on.
- Eyebrow, heading + tag
- Per column: optional image, heading, text
- Also supports a Custom Liquid block
- Section padding
Logo list
A row of press or partner logos (“As featured in…”).
- Heading
- Per logo: logo image, name (used as text fallback if no image is set)
- Also supports a Custom Liquid block
- Section padding
Lookbook
An editorial image grid with variable tile sizes — for a lookbook or campaign spread. Desktop uses a 6-column grid where each image can span 2–6 columns; mobile automatically simplifies to a plain 2-column grid.
- Eyebrow, heading (+ size and tag), subheading
- Per image: image, column span (2–6), ratio (Portrait / Square / Landscape / Wide), eyebrow, heading, link
- Also supports a Custom Liquid block
- Section padding
Before / After
An interactive drag slider comparing two images — great for showing product wear/durability over time, or a transformation.
- Eyebrow, heading + tag, text
- Before image + label, after image + label, image ratio
- Button text + link
- Section padding
The slider handle is fully keyboard-accessible — arrow keys, Home, and End all work, not just drag/touch.
Countdown timer
A live countdown to a specific date and time — for limited drops or sales deadlines.
- Eyebrow, heading + tag, text
- End date (YYYY-MM-DDTHH:MM:SS)
- Dark background toggle
- Button text + link
- Section padding
Once the countdown reaches zero it shows an “Ended” state instead of counting into negative numbers.
Image hotspot
A single image with clickable pins that link to real products — “shop the look” style.
- Eyebrow, heading + tag
- Image, ratio
- Per hotspot (up to 8): horizontal/vertical position (%), product picker, label fallback (used if no product is selected)
- Section padding
Pins are placed by percentage, so they stay correctly positioned across every screen size.
Image with text
The classic 50/50 layout — an image on one side, rich text and a button on the other. Good for brand story or product storytelling.
- Image, image position (Left / Right), image ratio
- Eyebrow, heading + tag, rich text
- Button text + link
- Section padding
Rich text
A flexible, block-based text section — mix and match Eyebrow, Heading, rich Text, and Button blocks in any order or combination for simple copy sections.
- Blocks, any order/combination: Eyebrow, Heading, Text (rich text), Button (style: Primary / Secondary / Ghost)
- Also supports a Custom Liquid block
- Section padding
Trust badges
A row of reassurance badges (shipping, returns, secure checkout, etc.) with a built-in icon set.
- Per badge: icon — 13 built-in options (truck, shield, refresh, gift, map pin, lock, clock, leaf, headset, badge check, gem, award, credit card) — or upload a custom icon image to override it
- Heading, text
- Section padding
Video
A full-width self-hosted video section with a poster fallback image, optional heading/button overlay, and a real pause/play control.
- Video URL (mp4), poster image (fallback), ratio
- Eyebrow, heading (+ size and tag)
- Button text + link
Ships with a visible pause button so autoplay doesn't violate accessibility guidelines (WCAG 2.2.2) — don't hide it with custom CSS.
Newsletter
A standalone email capture section, wired to Shopify's real customer signup (adds the “newsletter” tag) — separate from the footer's built-in signup form.
- Eyebrow, heading + tag, subheading
- Success message (optional override — defaults to “Thank you — check your inbox.”)
- Section padding
Blog posts
A preview grid of your latest blog posts, pulled from a real blog you choose — for surfacing journal/editorial content on the homepage or any page.
- Eyebrow, heading + tag
- Blog picker, posts to show (2–6)
- Link text + URL
- Section padding
Product recommendations
Shopify's real product recommendations, fetched live via Shopify's Recommendations API — not a hardcoded product list.
- Eyebrow, heading, heading tag
- Recommendation type — Related (similar products) or Complementary (pairs well together)
- Fallback collection, limit, columns (2–5)
- Section padding
“Complementary” relies on real purchase/co-occurrence data, so a brand-new store can see nothing until it has order history — always set a Fallback collection so the section never renders empty.
To show both Related and Complementary on the same product page, add this section twice with a different Recommendation type on each.
Featured product
Highlights one specific product in detail — good for a “Signature piece” callout.
- Eyebrow, product picker, heading tag
- Heading / description / price fallback text (shown only if no product is selected)
- Section padding
Supports app blocks, so review-app widgets etc. can be added directly inside it.
Featured collection
A single collection's products in a grid, with a heading and a “View all” link — the standard homepage “shop this collection” section.
- Eyebrow, heading + tag, subheading
- Collection picker, products to show (2–12), columns (2–5)
- Link text + URL
- Section padding
Collection list
A grid of collection tiles (“Shop by category”) — each tile links to one of your collections.
- Eyebrow, heading + tag
- Per tile (up to 8): collection picker, image (overrides the collection's own image), eyebrow, heading, description
- Also supports a Custom Liquid block
- Section padding
Testimonials
Customer quotes with optional star ratings, in either a grid or a slider layout.
- Eyebrow, heading + tag
- Show star rating toggle
- Layout — Grid or Slider (Slider adds autoplay + speed)
- Per testimonial (up to 12): quote, rating (0–5), name, title, avatar
- Also supports a Custom Liquid block
- Section padding
Star ratings use the same real gradient-fill component as the product page's review stars — not separate icon images.
Custom Liquid
A free-form insertion point for your own Liquid, HTML, CSS, or JS — or for pasting in an app's embed code that doesn't have its own app block.
- Liquid code
- Section padding
Content isn't validated by the theme — invalid code can break the page it's on, so preview before publishing.
Contact form
A real contact form wired to Shopify's native contact-form handler (submissions show up in Admin → Inbox), not a decorative form.
- Intro text
- Success message (optional override — defaults to “Thanks for reaching out — we'll get back to you shortly.”)
- Section padding
Automatically included on any page using the Contact page template — you don't need to add it manually if you used that template.
Page templates
These auto-render on their own page rather than being manually added — you configure them from the theme editor by selecting that page (e.g. any product, your cart, a blog post) instead of dragging them in.
Header
The sticky site header — logo, main navigation with an optional 3-level mega menu, search/account/cart icons, and the announcement bar above it.
- Logo text or logo image
- Main menu, customer account menu
- Announcement bar — enable, scroll speed, pause on hover, show currency/language picker
- Mega menu default promo — image, eyebrow, heading, link
- Blocks: Announcement message (repeatable, optional link), Menu item promo (overrides the default promo image for one specific top-level menu item)
The currency/language picker only appears once your store actually has more than one market or language configured — it's hidden automatically otherwise, and is always available in the footer too.
Footer
Brand blurb, newsletter signup, menu columns, social icons, and the copyright line.
- Brand name, brand description
- Newsletter — show toggle, heading/subheading/placeholder overrides
- Top spacing
- Social media icons toggle
- Copyright toggle + text override
- Blocks: Menu column (repeatable — heading + linked menu; ships with Shop / Company / Help by default)
Cart drawer
The slide-out cart panel that opens after adding a product, when Cart type is set to Drawer.
- No settings of its own — content comes from Theme settings → Cart
Switch between drawer and full cart page in Theme settings → Cart → Cart type.
Cart
The full /cart page, used when Cart type is set to Page.
- Eyebrow, order summary heading, empty-cart heading/subtext — all optional overrides, blank uses the translated default
- Section padding
Collection
Product grid for every collection page — filtering, sorting, and pagination all run on Shopify's real collection data.
- Heading size
- Show collection image toggle + ratio
- Section padding
Search
Search results page — covers products, articles, and pages, with the same filter sidebar as collection pages.
- Section padding (search behavior itself mirrors your store's real search settings)
404
Shown for any broken or missing URL.
- Eyebrow / heading / subheading overrides — optional, blank uses the translated default
- Heading size
- Primary button label (always links to your home page)
- Secondary button — toggle, label, link (blank link goes to your main collection)
- Section padding
Password
The gate page shown while your store is password-protected (Settings → Preferences).
- Message override — blank falls back to your store's real password message, then “Opening soon”
- Heading size, password field heading
- Email signup — toggle, heading/subheading
- Section padding
Gift card
The page a customer lands on when they open an issued gift card — code, balance, QR code, Apple Wallet, and print.
- Background gradient start/end colors (optional — blank uses your theme's accent/text colors)
- Show print button toggle
- Section padding
Required elements — gift card code, QR code, Apple Wallet button, shop name — always show per Shopify's Theme Store requirements and aren't toggleable.
Article
Individual blog post page — content, author, comments (if enabled on the blog), and social sharing.
- Heading size
- Section padding
Blog
The listing page for a given blog — post grid with pagination.
- Eyebrow override
- Heading size
- Posts per page (3–24)
- Section padding
Page
The generic page template — About, Terms, Shipping, or any page not using a more specific template.
- Eyebrow (blank hides it)
- Heading size
- Content width — Narrow (720px) or Wide (900px)
- Text alignment — Center or Left
- Section padding
A per-page featured image is optional and set via a custom.featured_image page metafield (Settings → Custom data → Pages), not a section setting — since this one template is shared by every page, a section-level image would put the same picture on all of them.
List collections
The /collections directory — a grid of every collection in your store.
- Eyebrow / heading overrides
- Heading size
- Sort collections by — Admin default / Alphabetical / Product count
- Hide empty collections toggle
- Collections per page (8–48)
- Section padding
Product
The main product page — gallery (images, video, and 3D models), variant picker, and configurable info blocks.
- Show in-store pickup toggle
- Quantity pricing — enable toggle + 3 tiers, each with a label and discount text
- Size chart — info only; real setup is a metaobject, see Custom data setup above
- Blocks (reorder/remove freely): Vendor, Price, Description, Materials and care, Usage and fit, Shipping and returns, plus app blocks
- Section padding
Quantity pricing tiers are display text only — they don't create a discount. Make sure a matching Shopify discount (Volume/Bulk) actually exists, or the page will advertise a price checkout won't honor.
Star ratings only appear once a product has real review data in the reviews.rating / reviews.rating_count metafields (the namespace Shopify's free Product Reviews app uses) — there's no placeholder rating.
The gallery automatically supports images, self-hosted or YouTube/Vimeo video, and 3D models based on what's uploaded to each product — no extra setting needed.