pluginforstore

Documentation

Section reference

Every section Vestige ships with, what it's for, and its settings.

← Back to docs

Content 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.