Sections
Complete reference for every section in Mast. Each entry documents all settings, block types, layout variants, and practical tips.
Chapter
chapterEditorial section opener with a large number or glyph, eyebrow text, heading, and optional lede paragraph.
Chapter is a divider section borrowed from editorial magazine design. It marks the opening of a new content chapter on a long page, giving readers a visual breath and a sense of structure. The large number or glyph is rendered at display scale using the heading font, making it a strong typographic accent.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Chapter number / glyph | text | 01 | The large typographic element displayed at display size. Can be a number, a letter, a Roman numeral, or a short symbol. |
Number alignment | select | left | Horizontal alignment of the chapter number: left, center, right. |
Number opacity | range | 20 | Opacity of the number element. Range: 5–100. Low opacity creates a watermark effect behind the text. |
Eyebrow text | text | | Small uppercase label above the heading. Rendered in the accent font with wide letter spacing. |
Heading | text | | Main chapter title. Rendered in heading font. |
Heading style | select | display | display (large) or editorial (slightly smaller with serif italic option). |
Lede | richtext | | Optional introductory paragraph below the heading. Supports basic inline formatting. |
Layout | select | left-aligned | left-aligned or centered. Centered works well for standalone chapter openers; left-aligned for pages with a strong reading column. |
Background color | color_scheme | default | Color scheme applied to the section background. Uses Paper, Highlight, or a custom color. |
Section padding top | select | xl | Vertical space above the section. |
Section padding bottom | select | large | Vertical space below the section. |
Tips
- —Use Chapter at the top of long collection or lookbook pages to set the editorial tone before imagery.
- —Combine a very low number opacity (8–12%) with a centered layout for an abstract, almost-hidden background element.
- —The eyebrow text field pairs well with the meta line field in Image Banner. Use both to build a consistent labeling system across your page.
- —If you use Chapter on every collection page, keep the chapter number as the collection number or season code for continuity.
Featured Collection
featured-collectionShowcases a collection with two layout options. Spread places a large hero image alongside product cards. Triptych arranges three equal-width columns for a clean product grid.
Featured Collection is the primary product-selling section. It pulls live products from a selected collection and renders them in one of two curated layouts. The spread layout is editorial, with one dominant image and products stacked alongside it. The triptych layout is cleaner and works well for collections with three hero products or a trio of equally-important items.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Collection | collection | none | The Shopify collection to pull products from. |
Layout | select | spread | spread or triptych. Spread uses one large hero image on the left with product cards on the right. Triptych uses three equal columns. |
Product count | range | 3 | Number of products to show. Range: 2–6. In triptych layout, 3 is recommended. |
Show hero image | checkbox | true | In spread layout, shows a standalone editorial image before the product cards. Disable to show only product cards. |
Hero image | image_picker | none | The large image shown in the spread layout hero slot. Separate from product images. |
Eyebrow | text | | Small label above the collection title. |
Title | text | | Section heading. Defaults to the collection title if left empty. |
Description | richtext | | Optional editorial paragraph below the title. Keep it short — one to three sentences. |
CTA label | text | View all | Label for the link to the full collection page. |
CTA URL | url | | Link destination for the CTA. Defaults to the collection URL. |
Show folio numbers | checkbox | false | Renders small sequential numbers over each product image, styled like magazine folio references. |
Product card style | select | editorial | editorial (tall portrait image, minimal text below) or standard (square image with price prominent). |
Show vendor | checkbox | false | Shows the product vendor above the title on each card. |
Show price | checkbox | true | Toggles price visibility on product cards. |
Image ratio | select | portrait | Aspect ratio for product card images: portrait (2/3), square (1/1), or landscape (4/3). |
Tips
- —In spread layout, upload a hero image that sets the editorial mood of the collection rather than showing a product. A model shot or location image works well here.
- —Use folio numbers for capsule or limited collections where the numbering adds to the editorial feel.
- —Keep the description field to two sentences maximum. More copy than that should live in a separate Rich Text section.
- —If your collection has fewer than three products, use triptych layout with count set to 2 for a balanced pair.
Lookbook
lookbookAn asymmetric editorial image grid with optional product hotspots and prose blocks. Inspired by fashion lookbook layouts.
Lookbook is the most editorial section in Mast. It renders images in an art-directed asymmetric grid where each image has its own size and position weight. Individual images can carry product hotspots, which open a quick-add panel when clicked. Prose blocks can be interspersed between images for editorial copy.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Grid style | select | asymmetric | asymmetric (art-directed positions) or grid (even columns). Asymmetric requires 4 or more images to look correct. |
Gap size | select | medium | Spacing between grid cells: none, small, medium, large. |
Section title | text | | Optional heading shown above the grid. |
Section eyebrow | text | | Label shown above the section title in accent font. |
Enable hotspots | checkbox | false | When enabled, each image block shows a hotspot product selector in the editor. Clicking a hotspot on the storefront opens a quick-add drawer. |
Blocks
ImageAn image block with optional alt text, aspect ratio override, hotspot product, and caption. Add 2–8 image blocks per lookbook.
ProseA text block that occupies one grid cell. Supports a heading and body paragraph. Use to break up the image grid with editorial copy.
Tips
- —For the asymmetric layout to read correctly, supply at least 4 and preferably 6 images.
- —Vary the aspect ratios across image blocks: mix portrait and landscape to create visual tension.
- —If using hotspots, add them sparingly. Hotspots on every image feel commercial. Hotspots on 2 or 3 images feel editorial.
- —The Prose block is most effective when placed as the third or fifth item in a 6-image grid. It creates a natural reading pause.
- —Keep caption text to one line. It sits at the bottom of the image and longer text will overlap.
Contents
contentsA numbered table of contents section linking to page anchors. Use on long editorial or lookbook pages.
Contents is a navigation section styled after magazine tables of contents. Each entry carries a folio-style number, a title, and an optional short description. Entries link to anchor IDs elsewhere on the page using smooth scrolling. It is most useful on long story-driven pages.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Section title | text | Contents | Heading displayed above the list. |
Layout | select | single | single (one column) or split (two columns for dense content lists). |
Number style | select | roman | How entry numbers are rendered: arabic (1, 2, 3), roman (I, II, III), or zero-padded (01, 02, 03). |
Show separator lines | checkbox | true | Renders a thin rule between each contents entry. |
Blocks
EntryOne table of contents item. Has a title, optional description, and an anchor target ID that corresponds to an id attribute on another section.
Tips
- —Add id attributes to target sections using the Custom CSS field in each section: give the section a unique ID and reference it in the anchor target.
- —Keep entry descriptions short, under 10 words. The point is navigation, not summary.
- —Contents works best at the top of a page, just after an Image Banner or Chapter opener.
- —Roman numerals feel more editorial; zero-padded numbers feel more magazine-like.
Rich Text
rich-textMultipurpose text section supporting an eyebrow, heading, body prose, and one or more CTA buttons.
Rich Text is the general-purpose content section. It is not specific to any context, making it suitable for brand manifestos, policy intros, editorial notes, and anywhere you need a passage of well-formatted copy. It supports a strict layout hierarchy: eyebrow, then heading, then body, then buttons.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Alignment | select | left | Text alignment: left or center. |
Narrow column | checkbox | false | Constrains the text to a narrower reading column (approx 60 characters per line). Recommended for long-form prose. |
Background scheme | color_scheme | default | Background color of the section: default (Paper), highlight, accent, or custom. |
Section padding top | select | large | Vertical spacing above. |
Section padding bottom | select | large | Vertical spacing below. |
Blocks
EyebrowSmall uppercase label in accent font. Rendered above the heading.
HeadingSection title in heading font. Supports up to h2 styling.
TextRich text paragraph block. Supports bold, italic, links, and lists through the Shopify rich text editor.
ButtonCTA button with a label and URL. Can be styled as primary (filled) or secondary (outlined). Add up to 3 button blocks.
Tips
- —For brand manifesto pages, enable narrow column and set padding to xl for a focused reading experience.
- —Mix a primary and a secondary button in the same section to offer a main action and a softer alternative.
- —The centered alignment with a short heading and two buttons is a classic below-the-fold newsletter or CTA section.
Press
pressPublication logo grid with an optional featured pull quote. Designed for social proof and press coverage.
Press renders publication logos in a horizontal strip with optional hover color treatment. Below the logo grid, an optional pull quote block shows a featured excerpt from a review or interview. The combination is a powerful trust signal on brand pages.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Section title | text | As seen in | Label above the logo grid. |
Logo size | range | 120 | Maximum width of each logo in pixels. Range: 60–200. |
Logo grayscale | checkbox | true | Renders logos in grayscale by default. On hover, logos shift to their original color. |
Logo alignment | select | center | Horizontal alignment of the logo strip: left, center, right. |
Show pull quote | checkbox | false | Reveals the pull quote block below the logo strip. |
Pull quote text | text | | The featured quote text. Keep it to one or two sentences. |
Pull quote attribution | text | | Attribution line shown below the quote: publication name, author, or both. |
Pull quote style | select | large | large (display-size quote mark, headline text) or inline (standard paragraph size). |
Blocks
LogoOne publication logo. Upload an image (SVG or PNG with transparent background is recommended) and optionally provide a link to the coverage.
Tips
- —Use SVG logos when possible. They render crisply at any size and scale with the logo size setting.
- —The grayscale-to-color hover effect adds interactivity without distraction. Keep it on unless your logos already look good in grayscale.
- —Use the pull quote for your most impactful line of press. One perfect quote beats five mediocre ones.
- —For a strong homepage, place the Press section after a Featured Collection and before the Newsletter.
FAQ
faqAccordion-style frequently asked questions section using native HTML details and summary elements for accessibility.
FAQ uses the native HTML details and summary elements, which means it works without JavaScript and is inherently accessible. The open/close animation is CSS-based. Up to 20 question/answer pairs can be added as blocks.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Section title | text | Frequently asked questions | Heading displayed above the accordion list. |
Layout | select | single | single (one column) or two-column (pairs of questions side by side, best for dense content). |
First item open | checkbox | false | Opens the first FAQ item by default on page load. |
Section padding top | select | large | Vertical spacing above. |
Section padding bottom | select | large | Vertical spacing below. |
Blocks
ItemOne FAQ entry. Has a question (the summary/heading) and an answer (the body, which supports rich text).
Tips
- —Group related questions by theme and use multiple FAQ sections with different titles (Shipping, Returns, Product Care) rather than one long list.
- —The native details element means FAQ content is indexable by search engines even when collapsed. Good for SEO.
- —Keep answers concise. If an answer needs more than three paragraphs, it should probably be its own page.
Custom Liquid
custom-liquidFreeform Liquid section for custom HTML, Liquid template code, or third-party app block embedding.
Custom Liquid gives developers and technically confident merchants a direct injection point into any page template. It renders whatever Liquid or HTML you paste into the code field. This is useful for embedding app-generated markup, adding structured data, or rendering content from metafields that no other section exposes.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Custom Liquid | liquid | | The Liquid / HTML code to render. Has access to all standard Liquid objects: shop, product, collection, customer, cart. |
Padding top | select | none | Vertical spacing above the rendered content. |
Padding bottom | select | none | Vertical spacing below the rendered content. |
Tips
- —Use Custom Liquid to embed app review widgets, size-guide apps, or loyalty program banners when those apps do not offer native app blocks.
- —Custom Liquid bypasses the design system. Add class names manually if you want it to match theme styling.
- —For structured data markup (JSON-LD), set padding to none and render only the script tag without visible HTML.
Multicolumn
multicolumnA flexible column grid for feature lists, brand values, service breakdowns, and similar structured content.
Multicolumn renders a configurable number of equal-width columns, each with an optional icon or image, a heading, and a paragraph. It is the right section for content that naturally falls into parallel groups: three brand values, four shipping options, five sustainability commitments.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Columns (desktop) | range | 3 | Number of columns on desktop. Range: 2–5. |
Columns (mobile) | range | 1 | Number of columns on mobile. Range: 1–2. |
Column alignment | select | left | Horizontal alignment of content within each column: left, center. |
Image style | select | icon | icon (small, treated as decorative) or image (larger, editorial weight). |
Section title | text | | Heading above the column grid. |
Section subtext | richtext | | Optional paragraph below the section title. |
Background scheme | color_scheme | default | Background color for the section. |
Blocks
ColumnOne column block. Has an image or icon, a heading, and a richtext paragraph. Add 2–6 column blocks.
Tips
- —For brand values, use centered alignment with an icon image and a heading in sentence case rather than all-caps.
- —For service features, left alignment with a small icon and a slightly longer description paragraph reads like a feature comparison table.
- —On mobile, setting columns to 1 produces a stacked list that reads cleanly without horizontal scrolling.
Blog Posts
blog-postsJournal or editorial blog grid. Pulls from a Shopify blog and renders article cards with images, dates, and excerpts.
Blog Posts renders a grid of article cards from a selected Shopify blog. It supports two grid styles: magazine (large featured first article alongside smaller secondary articles) and grid (uniform columns). It is designed to make the journal or editorial section of a brand feel like the front page of a publication.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Blog | blog | none | The Shopify blog to pull articles from. |
Post count | range | 3 | Number of articles to show. Range: 2–6. |
Layout | select | magazine | magazine (one large + secondary) or grid (even columns). |
Show date | checkbox | true | Renders the article publication date on each card. |
Show author | checkbox | false | Renders the author name below the date. |
Show excerpt | checkbox | true | Renders the article excerpt below the title. Uses the custom excerpt if set, otherwise truncates the first paragraph. |
Excerpt length | range | 120 | Maximum characters to show in the excerpt. Range: 60–200. |
Image ratio | select | landscape | Aspect ratio for article card images: landscape (4/3), portrait (2/3), or square (1/1). |
Section title | text | Journal | Heading above the article grid. |
CTA label | text | Read all | Label for the link to the blog archive page. |
Tips
- —The magazine layout requires at least 3 articles to look correct. The first article becomes the large featured card.
- —Always set a featured image on each article. Cards without images fall back to a solid background, which looks weak in editorial layouts.
- —Use the blog section on the homepage to drive traffic to your journal. Keep the post count at 3.
Testimonials
testimonialsCustomer quote section with name, optional photo, and star rating. Supports single and carousel layouts.
Testimonials renders customer quotes in a clean typographic layout. It is distinct from the Press section, which is for publication coverage. Testimonials is for direct customer voices. It supports a static single-quote layout and a multi-quote carousel with auto-advance.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Layout | select | carousel | carousel (multiple quotes with navigation) or grid (all quotes visible at once). |
Columns (grid) | range | 3 | Number of columns when layout is set to grid. Range: 1–4. |
Auto-advance | checkbox | true | In carousel layout, advances to the next quote automatically. |
Advance interval | range | 5 | Seconds between auto-advance. Range: 3–10. |
Show stars | checkbox | true | Renders a star rating row above the quote text. |
Section title | text | | Optional heading above the testimonial block. |
Background scheme | color_scheme | highlight | Background color for the section. |
Blocks
TestimonialOne customer quote. Has quote text, customer name, optional title or location, optional photo, and a star rating (1–5).
Tips
- —In carousel layout, add 4–6 testimonials for a good rotation without the set feeling repetitive.
- —Keep star ratings consistent. If most testimonials are 5 stars, show them all at 5. Mixing 3 and 5 star ratings feels unedited.
- —Customer photos are optional but substantially increase credibility. Even small headshots make a difference.
Collapsible Content
collapsible-contentExpandable content rows for size guides, care instructions, shipping policies, and other secondary information.
Collapsible Content is a general-purpose expandable section. Unlike FAQ, which is question-and-answer format, Collapsible Content is for non-FAQ content that simply benefits from progressive disclosure. It is commonly used on product pages for care instructions, fit guides, and returns policies.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Section title | text | | Heading above the collapsible list. |
First item open | checkbox | true | Opens the first item by default. |
Layout | select | default | default (full width) or narrow (constrained column). |
Blocks
ItemOne collapsible row. Has a heading (the toggle label) and a content body that supports rich text, images, and embedded Liquid.
Tips
- —On product page templates, Collapsible Content is the recommended place for shipping, returns, and care information. Keep it below the add-to-cart form.
- —Open the first item by default only when the content is genuinely important and not secondary. For a returns policy, the closed default is correct.
Contact Form
contact-formShopify's native contact form with configurable fields and a custom success message.
Contact Form uses Shopify's built-in form processing, which sends form submissions to the store's contact email. No external service or Liquid customization is needed. Fields beyond name, email, and message can be added as custom blocks.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Heading | text | Get in touch | Heading rendered above the form. |
Subtext | richtext | | Optional introductory paragraph. |
Submit label | text | Send | Label for the submit button. |
Success message | text | Thank you for your message. We will be in touch soon. | Message shown after a successful submission. |
Layout | select | default | default (full-width form) or split (copy on the left, form on the right). |
Blocks
Text fieldAdds a single-line text input with a configurable label and optional placeholder. Useful for order numbers, company names, or custom request fields.
Tips
- —In split layout, use the subtext field to explain response times, preferred contact methods, or what to include in the message.
- —The split layout also accepts an optional image block, which is effective on agency or about-page contact sections.
Header
headerSite-wide header with logo, navigation, search, and cart trigger. Configurable sticky behavior, folio strip, mega menu, and mobile drawer.
The Header is a global section available in every template. It is always the topmost section. Configuration options include the site logo or wordmark, the main navigation menu, a sticky scroll behavior, an optional folio strip, mega menu columns, and the mobile drawer layout.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Logo | image_picker | none | Site logo image. Upload a versión optimized for the header (SVG or PNG with transparent background). |
Logo width | range | 120 | Width of the logo image in pixels. Range: 50–250. |
Wordmark text | text | | If set, renders the store name in heading font instead of the logo image. Used when no separate logo asset exists. |
Enable sticky header | checkbox | true | When enabled, the header stays visible as the user scrolls down the page. |
Sticky behavior | select | always | always (always visible) or on-scroll-up (hides when scrolling down, shows when scrolling up). |
Enable folio strip | checkbox | false | Adds a thin bar above the main header row. Use for issue numbers, season labels, or trust badges. |
Folio strip content | text | | Text content of the folio strip. Supports plain text. |
Navigation menu | link_list | main-menu | The Shopify navigation menu to use for the main nav links. |
Enable mega menu | checkbox | false | When enabled, nav items with sub-items open a full-width mega menu dropdown rather than a simple dropdown list. |
Transparent header on hero | checkbox | false | Makes the header background transparent when positioned over an Image Banner section at the top of the page. |
Show search | checkbox | true | Shows the search icon in the header utility row. |
Show country/language selector | checkbox | false | Shows the Shopify Markets country and language selector in the header. |
Blocks
Mega menu columnOne column in the mega menu for a parent nav item. Supports a heading, a featured image, and a list of child links.
Tips
- —For transparent-header-on-hero to work correctly, the Image Banner must be the very first section in the template and the overlay opacity should be low enough for the header links to remain readable.
- —The folio strip is a distinctive editorial touch. Use it to display the current season or collection number, not for promotional messages (use Announcement Bar for those).
- —On-scroll-up sticky behavior is recommended for pages with long content. It reclaims vertical space while keeping the header accessible.
- —The mobile drawer uses the same navigation menu as desktop. Nested menu items become expandable groups in the drawer.
Announcement Bar
announcement-barA slim bar above the header for promotions, shipping thresholds, or notices. Supports multiple rotating messages.
Announcement Bar renders above the Header. It is the first element visible on the page. It supports multiple message slides that rotate automatically, a dismiss button, and configurable colors independent of the theme's color scheme.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
Auto-rotate | checkbox | true | Automatically cycles through messages. |
Rotation interval | range | 5 | Seconds between message transitions. Range: 3–10. |
Show dismiss button | checkbox | true | Renders an X button allowing the user to close the bar. Closed state persists in sessionStorage for the browser session. |
Background color | color | #080604 | Bar background color. Can differ from the main Paper token. |
Text color | color | #DEDBC8 | Text color inside the bar. |
Blocks
MessageOne announcement message with plain text and an optional link.
Tips
- —Keep messages to one line. Long messages wrap on mobile and break the compact strip layout.
- —Use the Announcement Bar for time-sensitive offers and shipping thresholds. Permanent messaging belongs in the folio strip or footer.
- —Setting a contrasting background color (e.g., accent color) versus the header color creates a clear visual separation.