A flexible block-based section for building custom layouts from a shared set of content blocks.
There's no section-level heading or text: blocks are the content. The blocks on this page are the theme's shared block set, and the same blocks appear in Media with content, Banner with content, Featured post, Build your own, and Vertically scrolling content, so this page is the full reference for all of them.
Styling
- Color scheme
- Content style - Standard, Filled, or Outlined. Filled reveals a Content color scheme.
This section also uses the standard Framing text, Corner text, Top line, and Crop marks settings described in Theme settings. For a short line above a heading, use the Heading block's own Accent text (below).
Blocks
| Block | What it does |
|---|---|
| Heading | A heading, with optional accent text above it. |
| Text | Rich text, with an optional large first letter, small-caps first line, two columns, justified text, and footnotes. |
| Button(s) | One button, or two side by side. |
| Image | An image with an optional shape and caption. |
| Divider | A horizontal rule, with an optional accent in the middle. |
| Quote | A quotation with a large opening quotation mark and an attribution. |
| Collapsible row | A heading that opens to show more. Great for FAQs, shipping info, and other tab-style content. |
| Icons with text | A group of icon and label pairs. |
| Numbers | A group of stats. |
| Stars | A star rating from 1 to 5. |
| Countdown | A countdown to a date and time you set. |
| Newsletter | An email signup form. |
| Rotating element | A rotating badge of text or an image. |
| Custom Liquid | Your own Liquid code. |
You can also add app blocks from apps you've installed.
Heading
- Accent text - a short line shown above the heading, wrapped in the theme's accent marks. Leave it blank for none. See how to use accent text and accent marks.
- Heading and Heading tag - H1 to H6. The tag sets the heading's level for search engines and screen readers.
Advanced styling adds Font size, Space above, Space below, and Alignment.
Text
| Setting | What it does |
|---|---|
| Text | The copy. Footnotes are written straight into it (see below). |
| Justify text | Gives the text column straight edges on both sides. |
| Columns | 1 or 2. Two columns flow the text side by side with a rule between them in the theme's border style. Desktop only; on mobile the text is one column. |
| First letter | Normal or Large. Large turns the first letter of the opening paragraph into a drop cap. |
| First line | Normal or Small caps. Small caps sets the first line of the opening paragraph in small capitals, like a newspaper lede. It pairs well with a large first letter. |
With Override default styles on, Advanced styling adds Font size, Space above, Space below, and Alignment, plus Large first letter size (how many lines of text the large letter spans, 2 to 4) when First letter is Large.
Adding a footnote
A footnote is written in double square brackets, right where it belongs in the text.
- Select the Text block and click into the Text field.
- Place your cursor just after the word or sentence the note is about.
- Type two opening square brackets, the note itself, then two closing square brackets. For example:
Our paper is left uncoated.[[Cotton paper will not yellow over time.]] It is heavier than most. - Repeat for any other notes. They're numbered automatically, in the order you write them.
On your store, each note is replaced by a small raised number in the text, and the notes are listed, numbered, under a rule at the foot of the block. The number in the text links down to its note, and the note links back up. A space typed before the brackets is dropped, so the number sits tight against the word before it. The numbers use the theme's accent marks, set in Theme settings.
Footnotes work in the Text block only. Other text fields show the brackets as you typed them.
Button(s)
- Label, Link, and Style - Solid, Outline, or Link.
- Show second button - adds a second button beside the first, with its own Label, Link, and Style (Outline by default).
Advanced styling adds Alignment.
Image
- Image - 1000x1000px .jpg recommended.
- Image width - 10% to 100% of the space available.
- Image shape - None, Square, Pill, Arch, Circle, Clover, or Stamp. Clover crops the image into four rounded lobes. Stamp gives it a perforated postage-stamp edge and keeps the image's own proportions. The other shapes crop to their own outline.
- Caption - a short line shown with the image.
- Caption position - Left, Bottom, or Right (shown once there's a caption). Left and Right run the caption up the side of the image on desktop; on mobile the caption always sits below the image.
Advanced styling adds Space above, Space below, and Alignment.
Divider
A horizontal rule that follows the theme's border style, width, and dash pattern from Theme settings, so every divider on your store matches.
- Accent - None, Star, Circle, Custom text, or Custom image, shown in the middle of the rule. Star and Circle are the same marks used by the scroll marker.
- Custom text - shown when the accent is Custom text. Keep it short.
- Custom image - shown when the accent is Custom image. 200x200px .png recommended; a simple mark on a transparent background works best.
Advanced styling adds Space above and Space below.
Quote
A quotation with a large opening quotation mark pinned to its left. The quote is always left aligned beside the mark and always uses the text color of its color scheme.
- Quote - the quotation itself.
- Attribution - who said it, shown underneath.
Advanced styling adds Font size, Space above, and Space below.
Collapsible row
- Heading - the row's label, shown when it's closed.
- Content - what's revealed when the row is opened.
Advanced styling adds Alignment and Header font (Heading font or Body font).
Icons with text
A group of icon and label pairs. Add an Icon with text block inside the group for each pair.
The group sets:
- Layout - Standard, Inline, or Columns. Columns reveals Columns (2 to 4) and Columns on mobile (1 or 2).
- Gap - the space between items.
- Content style - Standard, Filled, or Outlined, applied to the group as a whole. Filled reveals a Content color scheme.
Each Icon with text has:
- Icon - Check, Star, Heart, Leaf, Box, Truck, Returns, Globe, Chat bubble, or Custom. Custom reveals Custom icon image (SVG recommended, PNG or JPG also work) and Custom icon SVG code, which takes priority over the uploaded image if both are set.
- Icon size - 24px to 80px.
- Text - the label.
- Content style - Standard, Filled, or Outlined, for this item on its own. Filled reveals a Content color scheme.
Numbers
A group of stats. Add a Number block inside the group for each one. Each Number has a Number (for example "95%" or "10k") and a Label.
The group has the same Layout, Columns, Columns on mobile, Gap, and Content style settings as Icons with text.
Stars
- Rating - 1 to 5 stars.
Countdown
- End date - in the format YYYY-MM-DD.
- End time - in the format HH:MM, using the 24-hour clock.
- Expired message - shown once the countdown reaches zero.
- Content style - Standard, Filled, or Outlined. Filled reveals a Content color scheme.
Newsletter
- Heading and Subheading
- Placeholder - the hint text inside the email field.
- Button label
Signups are added to your customer list in Shopify.
Rotating element
| Setting | What it does |
|---|---|
| Badge text | The text that runs around the circle. |
| Font style | Display or Body. |
| Size | 100px to 400px across. |
| Color scheme | The badge's own colors. |
| Rotation behavior | Always rotate, Pause on hover, Rotate on hover, or Rotate on scroll. Rotate on scroll turns the element as the page scrolls; browsers that don't support scroll animation fall back to always rotating. |
| Animation speed | Slow, Medium, or Fast. |
| Animation direction | Clockwise or Counterclockwise. |
| Center image | An optional image in the middle of the badge. 500x500px .png recommended. |
| Link | Makes the badge clickable. |
Advanced styling adds Font size (larger text fits fewer characters around the circle) and Alignment.
Custom Liquid
- Liquid code - add your own Liquid, for example an embed from another service.
Advanced styling
Every block has Override default styles under Advanced styling. Turn it on to adjust that one block without changing the rest of the section; the settings it reveals for each block are listed above. Size and spacing sliders use the theme's override scale, where 0 is the default; see how to use the override scale.