pluginforstore

Documentation

Section reference

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

← Back to docs

Shared patterns

A few controls repeat across most sections, so they're explained once here rather than in every entry below:

  • Color scheme — every section picks one of your theme color schemes (Theme settings → Colors). Some sections add a "use custom colors" toggle to override it for that one section.
  • Heading highlight — most headings can highlight part of their text. Type the words to highlight in the "Highlighted words" field, or wrap them in [square brackets] directly in the heading. Styles: Gradient, Solid color, Badge, Underline, Glow — with an optional highlight font and an animate-in toggle.
  • Section padding — nearly every section has its own top and bottom padding, usually with separate desktop and mobile values, so spacing between sections stays consistent.
  • Heading tag — where offered, this changes only the semantic HTML tag (H2–H6) for SEO and accessibility; it doesn't change the visual size, which is set in Theme settings → Typography.
  • Scroll animations — the theme-wide AOS setting (Theme settings → Scroll animations) fades sections in as they enter the viewport; some sections have their own animate-on-scroll toggle on top of it.

Content sections

Drag-and-drop sections for building pages — add them from Add section in the theme editor, on the home page or any page using a JSON template. Drag to reorder.

Slideshow

The full-width hero slider — image or video slides with an animated text overlay, arrows, dots, and an optional autoplay progress bar. Each slide is a block, so you can mix image and video slides in one slideshow.

  • Desktop / mobile height
  • Behavior — loop, autoplay + delay, transition speed, pause on hover, and slider effect (Coverflow / Fade / Flip / Creative / Slide)
  • Controls — show arrows, arrow position (Top / Middle / Bottom), show dots, show progress bar, pagination height and position
  • Section background toggle + colors (progress bar, pagination)
  • Per Image slide: image, fit (crop / show whole), horizontal + vertical focal point, overlay opacity
  • Per Video slide: YouTube/Vimeo URL or a Shopify-hosted video, fit, focal point, overlay opacity
  • Per slide content: position, max width, subtitle, heading + tag, description, button label + link, button size, and per-slide background / text / accent colors

On mobile, slide content is always centered at the bottom for a consistent stacked layout, and arrows are hidden.

The progress bar only shows when autoplay is enabled.

Split slideshow

A two-image-per-slide hero — a left and right image that meet in the middle, with a heading block and a row of thumbnail icons to jump between slides.

  • Autoplay toggle + delay (ms)
  • Thumbnail size (px)
  • Color scheme, desktop / mobile padding
  • Per slide: left image, right image, thumbnail icon, heading + tag, description, overlay color + opacity
Products slideshow

An editorial product carousel — each slide features one product with a large headline, description, a main product image, a mini thumbnail, and up to three freely-positioned decorative images plus a background glow.

  • Color scheme, button label
  • Per slide: product, big heading (defaults to product title), subheading, description, main image + mini thumbnail (both default to the product image)
  • Per slide: up to 3 decor images, each with position (6 anchor points) and size (Small / Medium / Large)
  • Per slide: background glow ellipse color
Collage hero grid

A masonry-style grid of image and video tiles, each with its own overlay heading, button, and link — for a magazine-style landing block.

  • Grid gap, corner radius, section padding
  • Per Image tile: image, desktop width (1/1 down to 1/4), stretch-to-fill-row-height toggle, overlay heading + button + link, overlay position (9 anchor points)
  • Per Video tile: Shopify-hosted video or YouTube/Vimeo, desktop width, stretch toggle, muted autoplay, overlay content

YouTube tiles play on click; Vimeo supports background autoplay.

Use “stretch to fill row height” on a small tile so it matches the height of a taller neighbour.

Countdown hero

A hero banner counting down to a specific date and time — for a drop or a sale deadline — with a background image, headline, subheading, and CTA button.

  • Height (Small / Medium / Full screen), border radius
  • Heading + size + text transform, subheading + size
  • End date (YYYY-MM-DD) and end time (HH:MM)
  • Custom timer colors (background, text)
  • CTA button — toggle, label, link, style (Primary / Secondary)
  • Background image + background color

The countdown is hidden automatically once the offer ends.

Featured collection

One collection's products in a responsive grid, with a heading, optional subheading, and a “View all” link. Add-to-cart / choose-options buttons are built into each card.

  • Collection, products to show
  • Heading + subheading + tag, heading alignment, spacing below heading
  • “View all” link — toggle + label (shows only when a collection is set)
  • Grid — desktop columns, mobile columns, gap, card border radius
  • Button labels — add to cart / choose options / out of stock, show button icon, button style (Primary / Secondary)
  • Section padding (desktop + mobile)

When heading alignment is left or right, the “View all” link sits on the opposite side of the same row.

Product card image ratio and borders are set globally in Theme settings → Product card.

Collection showcase

A tabbed collection browser — a large right-hand image with a heading, description, and CTA on the left, and tabs that switch between collections, each showing a few products.

  • Small heading, description, right image, button label + link
  • Products per collection
  • Per Collection tab: collection, optional fallback image
Collection slideshow

A swipeable row of collection cards (“shop by category”) with portrait or square images and a heading.

  • Color scheme, image shape (Portrait / Square)
  • Heading + tag, title size (Small / Medium / Large)
  • Section heading, button text
  • Per Collection block: collection, optional custom image (overrides the collection's own image)
  • Section padding (desktop + mobile)
Featured product

Spotlights a single product against a background image, with an optional scrolling marquee banner above it. Good for a hero product or a “signature piece” callout.

  • Section visibility — Always / Mobile only / Desktop only
  • Product, color scheme, background image + fade-edges toggle
  • Marquee banner — toggle, text, repeat count, animation speed (desktop + mobile)
Product bundle

A build-your-own-bundle block — a hero image and heading, plus product blocks the shopper picks from, with configurable minimum and maximum item counts.

  • Heading tag, hero image, hero heading, hero text
  • Min / max items in the bundle
  • Color scheme, section padding (desktop + mobile)
  • Per Product block: product
Product comparison

A side-by-side comparison table for a hand-picked set of products, with configurable rows — ratings, stock status, free-text specs pulled from metafields, and visual bar scales.

  • Heading + tag + subheading + alignment
  • Products to compare (product list)
  • Colors — background, text, buttons/bars, borders; section padding
  • Row blocks: Vendor, Rating, Stock status, Text/spec (namespace.key metafield), Visual scale (numeric metafield + unit + max value)

Text and visual-scale rows read product metafields in namespace.key format; a text row falls back to the product vendor when the key is empty.

Shop the look

A single lifestyle image with clickable hotspots pinned to real products — tapping a pin opens a product card.

  • Heading, main image (1600×900 recommended), max width
  • Colors — hotspot, card background, text, section background
  • Section padding
  • Per Product hotspot: product, horizontal + vertical position (%)

Pins are positioned by percentage, so they stay put across every screen size.

Before / after comparison

A two-panel comparison — a background “before” image and a foreground “after” image, each with its own badge, heading, text, and button.

  • Section heading + tag + description
  • Left (background) image — badge label, text position, heading, subtitle, button label + link
  • Right (foreground) image — badge label, text position, heading, subtitle, button label + link
  • Section padding (desktop + mobile)
Image with accordion

An image beside an accordion — expanding a row swaps the image to that row's picture. Good for feature walk-throughs or an illustrated FAQ.

  • Image position (Left / Right), desktop image height + width %, mobile image height
  • Section heading + tag + alignment
  • Per Tab: tab image, tab heading, tab content (rich text), optional SVG icon
Scrolling image with text

A pinned-scroll section — an image card stays in view while paired text blocks scroll past it, one per image. Side-by-side or stacked on desktop.

  • Color scheme, desktop layout (Side by side / Stacked), block height, content max width
  • Per Image and text block: image, subheading, heading (+ font, tag), text (rich text), button label + link
Scrolling content

A sticky left image with a scrolling column of content blocks on the right — each block can be a collection list, a product list, or free text with a button.

  • Color scheme, section padding (desktop + mobile)
  • Per block (Collection list / Text content / Product list): sticky left image, subtitle, heading + tag
  • Collection list block: collections; Product list block: a collection; Text block: description + button
Sticky media expand

A video or image that scales up as it's scrolled through and briefly pins in place, with a text overlay (kicker, heading, button). A scroll-driven attention block.

  • Media type (Video / Image), video or image + alt text
  • Kicker, heading, button text + URL
  • Overlay color + opacity, animation size (Small / Medium / Large)
  • Sticky distance, top / bottom halt, trigger position, content text color

For video mode, the file's own thumbnail (set in Shopify admin) is used as the poster image.

Animated stats

A row of statistics that fade in and count up when scrolled into view, each with an icon, a target number with a suffix, a label, and a description.

  • Heading + tag + subtitle
  • Stat style (Card / Plain), animate-on-scroll toggle
  • Background image + overlay color + opacity
  • Optional custom colors (background, text, number/icon)
  • Per Statistic block: icon (large built-in set) or custom SVG, target number, number suffix (+, %, K…), label, description
Testimonials

Customer reviews with optional star ratings, in a Grid, Slider, or Card layout — with an option to feature the third review as a wide highlighted card.

  • Layout mode (Grid / Slider / Card), animate on scroll
  • Reviews shown in grid, feature-the-3rd-review toggle, card limit, grid size
  • Slider — auto-rotate + interval, arrows, pagination (Dots / Progress bar)
  • Card layout — avatar size, column + row gap
  • Content order (stars / text / author combinations), dash before author name, author style
  • Heading + tag + alignment, section spacing
  • Per Review card: avatar, star rating, review text, author name
Trust badges

A row or grid of reassurance badges (shipping, returns, secure checkout, etc.) with a large built-in icon set.

  • Layout design (Grid cards / Horizontal bar), page width (theme default / custom)
  • Section heading + tag + alignment, desktop columns, icon size, hover animation
  • Optional custom section colors (icon/border, background, text, card background)
  • Entry animation — None / Fade in / Slide up
  • Per Feature card: icon (built-in set) or custom SVG, heading, description, optional link
Brand scroller

An infinite marquee of partner or press logos (“as seen in…”).

  • Heading + tag + alignment, color scheme
  • Scroll speed, logo height, gap between logos
  • Section padding
  • Per Logo block: image, optional link
Body marquee

A simple full-width scrolling text strip, driven by repeatable message blocks.

  • Scroll speed, scroll direction, pause on hover
  • Background + text color
  • Per Message block: text (rich text)
Snake wavy marquee

A scrolling headline that follows a wave path, with deep typography control — hollow/filled/gradient text fill, an optional stroke, and a ribbon background behind the text.

  • Marquee text, section background override
  • Ribbon background — None / Solid / Gradient, plus thickness
  • Typography — font variable (theme heading / body / accent), desktop + mobile size, weight, transform, letter spacing
  • Text fill — Transparent / Solid / Gradient; optional text border (color + thickness)
  • Animation speed, wave amplitude, vertical padding
Grid gallery card

A gallery grid where each tile can be an image, an autoplaying video, or a product, with text that shows on hover or always.

  • Color scheme, heading alignment
  • Image ratio (Auto / Landscape / Square / Portrait), grid gap, mobile swipe, text visibility (On hover / Always)
  • Heading + tag + description + description size
  • Column radius (global theme radius / custom)
  • Per Image grid block: image, video + autoplay, product, text + text size
Social media gallery

A grid of social posts — image or video cards with a platform icon, handle, caption, and link out to the post.

  • Visibility (Always / Mobile only / Desktop only), desktop columns, mobile swipe, card aspect ratio
  • Heading + size + SEO tag + description + alignment
  • Colors — section background, card overlay gradient, card text, overlay opacity
  • Section spacing (desktop + mobile)
  • Per Social card: image, optional video, social icon, handle/username, caption, link
Featured blog posts

A preview grid of the latest posts from a blog you choose, with optional date, author, and excerpt.

  • Color scheme
  • Heading + tag, blog picker, “View all” link text
  • Show date / author / excerpt toggles
  • Section padding (desktop + mobile)
Newsletter

A standalone email capture section wired to Shopify's customer signup — separate from the footer signup. Built from blocks (subheading, heading, text, email form) you arrange in any order.

  • Color scheme, desktop layout (Image left / Image right / Centered), image
  • Section padding (desktop + mobile)
  • Blocks: Subheading, Heading (+ size), Text, Email form (placeholder, button label + style, show icon)
Collapsible content

A heading and description beside (or above) an accordion of expandable rows — a flexible FAQ or details section.

  • Color scheme, desktop layout (Stacked / Split), container width (Standard / Narrow / Full width)
  • Accordion style (Boxed cards / Minimal border), item title size
  • Heading + tag, description + text size, text alignment
  • Section padding (desktop + mobile)
  • Per Accordion item: question/title, answer/content (rich text)
Contact form

A contact form wired to Shopify's native contact handler (submissions arrive in Admin → Inbox / your store email), with a heading.

  • Heading + size (H1 / H2 / H3) + alignment
  • Color scheme, section padding

Already included on the Contact page template — you don't need to add it manually if you used that template.

Store locator

A store directory with a filterable card list and an optional rotating 3D globe that flies to a store when its card is selected.

  • Kicker, heading + tag, subheading
  • Globe — show toggle, “Nearest to me” button + label, hint text, animate cards
  • Filter chip / card list labels, directions link label
  • Per Store block: name, region (used to group filter chips), image, address, phone, services (comma-separated), latitude + longitude, optional directions link, UTC offset + open/close hours

The globe loads D3 and a world map from a CDN the first time it scrolls into view; the store cards work with or without it.

Custom Liquid

A free-form insertion point for your own Liquid, HTML, CSS, or JS — or for pasting an app embed that has no app block of its own.

  • Liquid code
  • Color scheme
  • Section padding

Content isn't validated by the theme — invalid code can break the page it's on, so preview before publishing.

These render in fixed positions rather than being dragged into the page body. The header and announcement bar are edited from the Header group, the footer from the Footer group, and the drawers / overlays (cart, search, quick view, scroll-to-top, popup) from their own entries in the theme editor.

Header

The site header — logo (image or brand-name text), main menu with mega-menu blocks, and search / account / cart. Supports a sticky mode and a transparent mode on the home page.

  • Color scheme
  • Sticky header toggle
  • Transparent header (home page only) + transparent text color, header pill color, header text color
  • Main menu, logo, brand name (fallback when no logo image is set)
  • Mobile menu — show social icons, show currency picker
  • Standard mega menu block — menu handle, promo collection, promo image, button label + link
  • Collection tabs menu block — menu handle, up to 5 collections
Announcement bar

The scrolling strip above the header — rotating messages with optional icons, plus social icons and a currency picker on the sides.

  • Color scheme, show social icons, show currency picker
  • Scroll speed + direction, pause on hover
  • Optional custom colors (background, text, social icon)
  • Section padding (desktop + mobile)
  • Per Message block: text (rich text), leading icon from a built-in set

On mobile the side social icons and currency selector are hidden — enable them in the header's mobile menu settings so they stay reachable.

Footer

The site footer — a block-based column layout (logo/text, contact info, menus, newsletter, free text), plus a utility row with currency / language selectors, social icons, payment icons, Follow on Shop, and the copyright line.

  • Color scheme, background image + opacity
  • Footer style (Editorial / Centered), heading tag, uppercase column headings, separator
  • Currency selector, language selector, social icons + spacing
  • Copyright text toggle + custom text, “Powered by Shopify” toggle
  • Payment icons + spacing, Follow on Shop button, bottom links (link list)
  • Column blocks: Logo and text, Contact information, Menu, Newsletter, Text — each with its own column width
Cart drawer

The slide-out cart panel that opens after adding a product. Its behaviour and free-shipping bar are configured on the Cart page section (see below).

  • No settings of its own
Predictive search drawer

The search panel with live suggestions as you type, plus a configurable list of “popular searches”.

  • Per Popular search block: collection, label (defaults to the collection title)
Quick view drawer

The slide-out product preview opened from a product card's quick-view button — a compact version of the product form built from blocks.

  • Blocks: Title, Price, Variant picker (Dropdown / Buttons + labels), Quantity selector, Buttons (dynamic checkout toggle, quantity multipliers), Description, plus app blocks
Scroll to top

A floating button that appears once the shopper scrolls down, with a circular scroll-progress ring.

  • Button background, icon + progress color, button size
  • Position (Bottom right / Bottom left), offset from bottom
Popup newsletter

A timed email-capture modal with an image, heading, subtext, and a disclaimer line.

  • Enable popup, popup delay
  • Image, background / text / button colors
  • Heading, subtext, input placeholder, disclaimer text

Page templates

These auto-render on their own page rather than being manually added — you configure them by selecting that page (any product, your cart, a blog post) in the theme editor.

Product

The main product page — media gallery (images, video, 3D models), variant picker, and a fully block-based information column you reorder and remove freely.

  • Gallery layout — Gallery (thumbnail rail) or Slideshow (full-bleed) + autoplay
  • Sticky add-to-cart bar toggle
  • Container width (Small / Medium / Large / Full), media aspect ratio
  • Section padding (top / bottom)
  • Info blocks: SKU, Vendor, Title, Price (hide shipping text), Rating, Text, Custom liquid, Countdown, Icon with text, Quantity selector, Payment icons, Variant picker (Dropdown / Buttons), Buttons (dynamic checkout, quantity multipliers), Inventory status (thresholds + messages + colors), Description (Accordion / Full width), Collapsible row (custom text or a page), Custom content, Size chart (Popup / Accordion / Full width, links a page), Pickup availability, Social sharing, Ask a question, Notify me / Back in stock, Complementary products, Divider, Discount coupon, Free shipping bar, Delivery estimate, plus app blocks

The size chart block points at a normal Shopify page — no metaobject setup required. Assign a page per product with a Size chart block, or set one page for all.

Every block has its own desktop and mobile top/bottom padding, so spacing between blocks stays under your control.

The gallery adapts to whatever each product has uploaded — images, video, and 3D models — with no extra setting.

Collection

The product grid for every collection page — filtering, sorting, and pagination all run on Shopify's real collection data.

  • Products per page, desktop columns, mobile columns (1 / 2), grid gap
  • Pagination type — Page numbers / Load more / Infinite scroll
  • Toolbar — show sorting, show filter button
  • Header — alignment (Left / Center), show description
  • Section padding (desktop + mobile)

Product card image ratio and card borders are set globally in Theme settings → Product card, not per section.

List collections

The /collections directory — a grid of every collection in your store.

  • Heading + tag
  • Collections per page, desktop columns, mobile columns (1 / 2)
  • Card image ratio (Portrait / Square / Landscape), text alignment
  • Pagination style — Load more / Infinite scroll / Page numbers
  • Section padding (desktop + mobile)
Cart

The full /cart page. This section also holds the settings the cart drawer uses.

  • Free shipping bar — show toggle, threshold (0 hides it)
  • Enable order notes
  • Top / bottom padding
Blog

The listing page for a blog — a post grid with optional tag filters.

  • Heading tag, show tag filters
  • Articles per page, desktop columns
  • Card image ratio (Landscape / Square / Portrait / Adapt), show date / author / excerpt
  • Section padding
Article

The individual blog-post page — content, author, comments (if enabled on the blog), and social sharing.

  • Color scheme
Search

The search results page — products, articles, and pages, using your store's real search settings.

  • Color scheme
  • Section padding
Page

The generic page template — About, Terms, Shipping, or any page not using a more specific template. The Contact page template adds a Contact form section on top of this.

  • Show page title, center page title
  • Color scheme, section padding
Password

The gate page shown while your store is password-protected (Settings → Preferences), with a newsletter view and a password view.

  • Brand identity — custom brand name or logo image, logo width + max height
  • Newsletter view — headline, subheadline, placeholder, button text, success message
  • Password view — headline, subheadline, placeholder, button text
  • Color scheme, optional spotlight glow effect + color
  • Section padding (desktop + mobile)
404

Shown for any broken or missing URL.

  • Section color scheme + colors (background, left panel, text)
  • Optional overlay image (transparent PNG), heading, subtext, button text
  • Quick links — show collection chips + pick popular collections
  • Marquee — show toggle, text, animation speed
Gift card

The page a customer lands on when they open an issued gift card — code, balance, QR code, and print. Rendered as a standalone page with no editable section.

  • No theme-editor settings
Customer account pages

Login, Register, Activate account, Reset password, Account, Order, and Addresses — the storefront customer flow. Styling follows your color scheme and typography; there are no per-section content settings.

  • No theme-editor settings — controlled by theme-wide colors and typography