Content blocks

Three sections in Lapels have no fixed content of their own. Instead they hand you an empty frame and a set of content blocks to stack inside it. A heading, a line of text, a button, a picture, a countdown. You decide what goes in, and in what order.

The sections that work this way are Media hero, Image with text and Rich text. The same blocks are also what a Page template is built from, so an About page or a Contact page is assembled the same way. This page documents the blocks once. Those pages describe only the frame each one puts around them.

Tip

Blocks are added, reordered and removed exactly like sections. Open the section in the theme editor, click Add block, then drag to reorder. Order in the sidebar is order on the page.

Heading

The section’s headline.

Setting	What it does	Default
Heading	The line itself. It is inline rich text, so you can italicize part of it. Italics print in the emphasis font, which is how Lapels draws a second voice into one line.	”Cut with intention, worn for years.”
Width	How far the line runs before it wraps. Choose Narrow, Normal, Wide, or Full width.	Normal
Size	Display, Heading 1, Heading 2, or Heading 3. Display is the largest and is meant for the top of a page.	Heading 2
Line height	Theme default, Tight, Normal, or Loose. Tight suits a two-line display heading. Loose suits a small heading over several lines.	Theme default
Alignment	Left, center, or right.	Left

Size is not heading level. Size picks how large the line is drawn. The theme decides the underlying heading level, so the page keeps one clean heading outline for screen readers and search engines. You never have to think about it.

Text

A paragraph, or several.

Setting	What it does	Default
Text	Rich text, so bold, italic, links and lists all work.	A short paragraph about the house
Style	Body for normal copy, Intro for the larger opening line under a heading, Label for the small letter-spaced line above one.	Body
Alignment	Left, center, or right.	Left

The Label style is the small capitalized line you see above most headings in the theme. Put one above a Heading block and the pair reads as a titled section.

Button

Setting	What it does	Default
Link label	The words on the button. Write the destination into the label, so “Shop the collection” rather than “Click here”. The label is what a screen reader announces.	”Shop the collection”
Link	Where it goes. Pick a collection, product, page or blog, or paste a URL.	All products
Style	Primary is the filled button, Secondary the outlined one, Ghost the underlined text link with no box.	Primary
Open in a new tab	For a destination outside your store.	Off

Two buttons side by side read best as one Primary and one Secondary or Ghost. Two filled buttons compete with each other.

Image

Setting	What it does	Default
Image	The picture.	Empty
Aspect ratio	Natural keeps the file’s own shape. Square (1 by 1), Portrait (4 by 5) and Landscape (3 by 2) crop to a fixed shape, which is what keeps a row of pictures even.	Natural
Caption	A line under the picture.	Empty
Reveal on scroll	Fades and lifts the picture into place as it comes up the page.	On

Video

Plays a file you have uploaded to Shopify, or embeds one from YouTube or Vimeo.

Setting	What it does	Default
YouTube or Vimeo URL	Paste a watch or share link.	Empty
Video	Or pick a file you uploaded to Shopify, which plays without the third party’s player and without its cookies.	Empty
Captions file	A WebVTT (.vtt) captions file for a film that has sound. Upload it to Content → Files first, then name it here.	Empty
Poster image	The still shown before play. Without one the theme uses the film’s own first frame.	Empty
Ratio	Natural, Wide (16 by 9), Landscape (4 by 3), Square (1 by 1), or Portrait (3 by 4).	Natural
Caption	A line under the film.	Empty
Reveal on scroll	Fades the frame into place.	On
Autoplay	Starts the film muted when it comes into view.	On
Play as loop	Repeats it.	On

Caution

A film with speech needs a Captions file. Autoplay always starts muted, so anything the film says has to be readable as text. A visitor who has asked their device for reduced motion gets the poster and a play button instead of a moving picture.

Icon with text

One line-drawn mark with a short claim beside it.

Setting	What it does	Default
Icon	One mark from the theme’s shared set. Choose Needle, Scissors, Hanger, Shirt, Tape measure, Ironing, Wash, Leaf, Wheel, Flame, Mug, Droplet, Brush, Microwave, Star, Diamond, Scale, Certificate, Hammer, Sparkles, or Signature.	Hanger
Heading	The short claim.	”Shipped in 48 hours”
Text	One or two lines under it.	A sentence about dispatch
Heading level	Heading 2, Heading 3, or Plain text. Use Plain text when the line is a label rather than a real heading.	Heading 3

The mark is decorative and carries no name of its own. The heading beside it is what a screen reader reads, which is why the heading is the field that matters.

Product card and Collection card

Drop a single product or a single collection into a layout, drawn as the same card the rest of the store uses.

Setting	What it does	Default
Product / Collection	Which one to show.	Empty
Color scheme	Lets the card sit on its own background, which is how you make one card stand off a photograph.	scheme-paper

Testimonial

One customer quote.

Setting	What it does	Default
Quote	What they said.	A line about an overcoat
Rating	0 to 5 stars. Set it to 0 to leave the stars off.	5
Author	Who said it.	”Elliot Vance”
Role	Their trade and city, printed small under the name.	”Architect, Copenhagen”
Image	An optional portrait.	Empty
Style	Card draws a bordered panel, Plain sets the quote straight on the section’s ground.	Card
Alignment	Left or center.	Left

For a whole wall of these rather than one, use Customer quotes.

Countdown and Deal countdown

Countdown is the clock on its own. Deal countdown is the same clock with a heading, a paragraph and a discount code around it.

Setting	What it does	Default
Ends on	The deadline, written YYYY-MM-DD HH:MM in your store’s timezone. For example, 2026-11-29 23:59.	A date in 2027
Message once it has ended	Takes the place of the clock after the date passes.	”This countdown has ended.”
Style	Ruled, Ledger, or Clock.	Clock
Heading, Text, Heading level	Deal countdown only. The copy around the clock.	”Don’t miss the deal”
Discount code	Deal countdown only. Printed beside the clock for the customer to copy.	”SALE30”

Caution

The clock counts down to a fixed date you type. It does not create the discount. Make the code in Discounts in your Shopify admin, and set it to expire at the same moment. Otherwise the clock hits zero while the code still works.

Trust badges

Setting	What it does	Default
Heading	The reassurance.	”Guaranteed safe checkout”
Icon	Choose Award, Card payment, Checkmark, Shield, Padlock, or None.	Shield
Heading level	Heading 2, Heading 3, or Plain text.	Plain text

Group

A box you put other blocks inside, so a column of copy can sit beside a picture, or three buttons can run in a row.

Setting	What it does	Default
Direction	Column stacks what is inside it. Row sets it side by side.	Column
Alignment	Left, center, or right.	Left
Gap	The space between the blocks inside, 0 to 96px.	24px
Inherit color scheme	On, the group is invisible and takes the section’s colors. Turn it off to give the group its own scheme, which is how you draw a solid panel of copy over a photograph.	On
Color scheme	The group’s own colors, once inheriting is off.	scheme-paper

A Group can hold another Group, so a two-column layout is a Row holding two Columns.

Divider and Spacer

Divider draws one of the theme’s hairlines across the frame. Spacer adds empty height and draws nothing.

Setting	What it does	Default
Width	Divider only. Contained stops at the text column, and Full width runs the whole frame.	Contained
Spacing	Divider only. The room above and below the line, 0 to 80px.	16px
Draw on scroll	Divider only. The line draws itself from one side as it comes into view.	On
Height	Spacer only. 8 to 160px.	48px

Custom Liquid

One Code field that takes an app snippet or Liquid of your own. See Custom Liquid for the full-width section version and for what to watch out for.

Related: Media hero · Image with text · Rich text · Blog and pages · Lapels support replies within 12 hours.