Sections Reference

Sections

Complete reference for every section in Mast. Each entry documents all settings, block types, layout variants, and practical tips.


Image Banner

image-banner

Full-width or split-layout hero banner. The primary above-the-fold section for homepages and collection landing pages.

Image Banner is the most versatile hero section in Mast. It supports two layout modes: full, where the image fills the entire section and text overlays it, and split, where the image occupies one side and the text block the other. Both modes support independent desktop and mobile image sources so you can art-direct the crop for each viewport.

Settings

SettingTypeDefaultDescription
Layoutselectfullfull or split. Full covers the section with the image; split places image and text side by side.
Image (desktop)image_pickernonePrimary image shown on screens wider than 768px.
Image (mobile)image_pickernoneImage shown on screens narrower than 768px. Falls back to desktop image if not set.
Image ratio (full)selectautoAspect ratio for full layout: auto (natural height), 16/9, 4/3, 1/1, or natural.
Split image positionselectleftWhether the image appears on the left or right side in split layout.
Split image widthrange50Percentage width of the image column in split layout. Range: 40–70.
Overlay colorcolor#000000Color of the overlay rendered over the image in full layout.
Overlay opacityrange30Opacity of the overlay. Range: 0–80. At 0 no overlay is rendered.
Text positionselectmiddle-center9-zone grid for text alignment in full layout: top/middle/bottom combined with left/center/right.
Text color schemeselectlightlight or dark. Controls text and button colors when overlaid on the image.
Masthead labeltextSmall label shown above the heading in monospace or accent font. Use for collection names, season labels, or issue numbers.
Meta linetextA secondary label shown below the heading. Use for dates, locations, or subtitle copy.
Cover labeltextA rotated or positioned label that acts like a magazine cover sticker. Supports short strings.
Image captiontextSmall caption text shown at the bottom edge of the image. Good for photo credits or location tags.
Section padding topselectmediumVertical space above the section: none, small, medium, large, xl.
Section padding bottomselectmediumVertical space below the section.

Blocks

Heading

Main headline. Renders in heading font at display scale. Supports plain text and basic formatting.

Subheading

Secondary text block below the heading. Renders at body scale.

Button

CTA button with a label and URL. Supports primary and secondary style variants. Up to 2 buttons per section.

Tips

  • For the best mobile experience, always supply a separate mobile image cropped to portrait orientation.
  • In split layout, set the split image width to 55–60% when the image has a lot of visual weight on the left.
  • Use the masthead label field to inject season or collection names without breaking the heading hierarchy.
  • Keep overlay opacity between 20 and 45 for legibility without completely obscuring the image.
  • The cover label is best used with a short string of 1–3 words. Longer strings will overflow their container.

Chapter

chapter

Editorial 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

SettingTypeDefaultDescription
Chapter number / glyphtext01The large typographic element displayed at display size. Can be a number, a letter, a Roman numeral, or a short symbol.
Number alignmentselectleftHorizontal alignment of the chapter number: left, center, right.
Number opacityrange20Opacity of the number element. Range: 5–100. Low opacity creates a watermark effect behind the text.
Eyebrow texttextSmall uppercase label above the heading. Rendered in the accent font with wide letter spacing.
HeadingtextMain chapter title. Rendered in heading font.
Heading styleselectdisplaydisplay (large) or editorial (slightly smaller with serif italic option).
LederichtextOptional introductory paragraph below the heading. Supports basic inline formatting.
Layoutselectleft-alignedleft-aligned or centered. Centered works well for standalone chapter openers; left-aligned for pages with a strong reading column.
Background colorcolor_schemedefaultColor scheme applied to the section background. Uses Paper, Highlight, or a custom color.
Section padding topselectxlVertical space above the section.
Section padding bottomselectlargeVertical 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.

Lookbook

lookbook

An 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

SettingTypeDefaultDescription
Grid styleselectasymmetricasymmetric (art-directed positions) or grid (even columns). Asymmetric requires 4 or more images to look correct.
Gap sizeselectmediumSpacing between grid cells: none, small, medium, large.
Section titletextOptional heading shown above the grid.
Section eyebrowtextLabel shown above the section title in accent font.
Enable hotspotscheckboxfalseWhen enabled, each image block shows a hotspot product selector in the editor. Clicking a hotspot on the storefront opens a quick-add drawer.

Blocks

Image

An image block with optional alt text, aspect ratio override, hotspot product, and caption. Add 2–8 image blocks per lookbook.

Prose

A 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

contents

A 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

SettingTypeDefaultDescription
Section titletextContentsHeading displayed above the list.
Layoutselectsinglesingle (one column) or split (two columns for dense content lists).
Number styleselectromanHow entry numbers are rendered: arabic (1, 2, 3), roman (I, II, III), or zero-padded (01, 02, 03).
Show separator linescheckboxtrueRenders a thin rule between each contents entry.

Blocks

Entry

One 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-text

Multipurpose 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

SettingTypeDefaultDescription
AlignmentselectleftText alignment: left or center.
Narrow columncheckboxfalseConstrains the text to a narrower reading column (approx 60 characters per line). Recommended for long-form prose.
Background schemecolor_schemedefaultBackground color of the section: default (Paper), highlight, accent, or custom.
Section padding topselectlargeVertical spacing above.
Section padding bottomselectlargeVertical spacing below.

Blocks

Eyebrow

Small uppercase label in accent font. Rendered above the heading.

Heading

Section title in heading font. Supports up to h2 styling.

Text

Rich text paragraph block. Supports bold, italic, links, and lists through the Shopify rich text editor.

Button

CTA 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

press

Publication 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

SettingTypeDefaultDescription
Section titletextAs seen inLabel above the logo grid.
Logo sizerange120Maximum width of each logo in pixels. Range: 60–200.
Logo grayscalecheckboxtrueRenders logos in grayscale by default. On hover, logos shift to their original color.
Logo alignmentselectcenterHorizontal alignment of the logo strip: left, center, right.
Show pull quotecheckboxfalseReveals the pull quote block below the logo strip.
Pull quote texttextThe featured quote text. Keep it to one or two sentences.
Pull quote attributiontextAttribution line shown below the quote: publication name, author, or both.
Pull quote styleselectlargelarge (display-size quote mark, headline text) or inline (standard paragraph size).

Blocks

Logo

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

Newsletter

newsletter

Email capture section integrated with Shopify's customer list. Supports editorial copy and a custom success message.

Newsletter uses Shopify's built-in newsletter signup form, which adds subscribers directly to the Customer section of your Shopify admin with the newsletter consent flag set. No third-party integration is required, though you can connect Shopify Email or an external ESP like Klaviyo from the Shopify admin.

Settings

SettingTypeDefaultDescription
EyebrowtextSmall label above the heading.
HeadingtextStay in the loopMain headline for the section.
SubtextrichtextBrief description of what subscribers will receive.
Email placeholdertextYour emailPlaceholder text inside the email input field.
Submit labeltextSubscribeLabel for the subscribe button.
Success messagetextThank you for subscribing.Message shown after a successful signup.
Layoutselectcenteredcentered or split. Centered stacks all content. Split puts the copy on the left and the form on the right.
Background schemecolor_schemehighlightBackground color for the section.

Tips

  • The split layout works well at the bottom of collection pages: the headline describes the collection, the form captures interest in future drops.
  • Use the eyebrow field to set a membership-style framing, such as Join the circle or Subscribe to the journal.
  • Keep the subtext to one sentence. Longer copy reduces conversión.

FAQ

faq

Accordion-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

SettingTypeDefaultDescription
Section titletextFrequently asked questionsHeading displayed above the accordion list.
Layoutselectsinglesingle (one column) or two-column (pairs of questions side by side, best for dense content).
First item opencheckboxfalseOpens the first FAQ item by default on page load.
Section padding topselectlargeVertical spacing above.
Section padding bottomselectlargeVertical spacing below.

Blocks

Item

One 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-liquid

Freeform 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

SettingTypeDefaultDescription
Custom LiquidliquidThe Liquid / HTML code to render. Has access to all standard Liquid objects: shop, product, collection, customer, cart.
Padding topselectnoneVertical spacing above the rendered content.
Padding bottomselectnoneVertical 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

multicolumn

A 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

SettingTypeDefaultDescription
Columns (desktop)range3Number of columns on desktop. Range: 2–5.
Columns (mobile)range1Number of columns on mobile. Range: 1–2.
Column alignmentselectleftHorizontal alignment of content within each column: left, center.
Image styleselecticonicon (small, treated as decorative) or image (larger, editorial weight).
Section titletextHeading above the column grid.
Section subtextrichtextOptional paragraph below the section title.
Background schemecolor_schemedefaultBackground color for the section.

Blocks

Column

One 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-posts

Journal 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

SettingTypeDefaultDescription
BlogblognoneThe Shopify blog to pull articles from.
Post countrange3Number of articles to show. Range: 2–6.
Layoutselectmagazinemagazine (one large + secondary) or grid (even columns).
Show datecheckboxtrueRenders the article publication date on each card.
Show authorcheckboxfalseRenders the author name below the date.
Show excerptcheckboxtrueRenders the article excerpt below the title. Uses the custom excerpt if set, otherwise truncates the first paragraph.
Excerpt lengthrange120Maximum characters to show in the excerpt. Range: 60–200.
Image ratioselectlandscapeAspect ratio for article card images: landscape (4/3), portrait (2/3), or square (1/1).
Section titletextJournalHeading above the article grid.
CTA labeltextRead allLabel 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

testimonials

Customer 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

SettingTypeDefaultDescription
Layoutselectcarouselcarousel (multiple quotes with navigation) or grid (all quotes visible at once).
Columns (grid)range3Number of columns when layout is set to grid. Range: 1–4.
Auto-advancecheckboxtrueIn carousel layout, advances to the next quote automatically.
Advance intervalrange5Seconds between auto-advance. Range: 3–10.
Show starscheckboxtrueRenders a star rating row above the quote text.
Section titletextOptional heading above the testimonial block.
Background schemecolor_schemehighlightBackground color for the section.

Blocks

Testimonial

One 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-content

Expandable 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

SettingTypeDefaultDescription
Section titletextHeading above the collapsible list.
First item opencheckboxtrueOpens the first item by default.
Layoutselectdefaultdefault (full width) or narrow (constrained column).

Blocks

Item

One 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-form

Shopify'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

SettingTypeDefaultDescription
HeadingtextGet in touchHeading rendered above the form.
SubtextrichtextOptional introductory paragraph.
Submit labeltextSendLabel for the submit button.
Success messagetextThank you for your message. We will be in touch soon.Message shown after a successful submission.
Layoutselectdefaultdefault (full-width form) or split (copy on the left, form on the right).

Blocks

Text field

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

Announcement Bar

announcement-bar

A 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

SettingTypeDefaultDescription
Auto-rotatecheckboxtrueAutomatically cycles through messages.
Rotation intervalrange5Seconds between message transitions. Range: 3–10.
Show dismiss buttoncheckboxtrueRenders an X button allowing the user to close the bar. Closed state persists in sessionStorage for the browser session.
Background colorcolor#080604Bar background color. Can differ from the main Paper token.
Text colorcolor#DEDBC8Text color inside the bar.

Blocks

Message

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