HeirloomHelp CenterContact support

Theme blocks

Theme blocks are the pieces you build sections from: headings, text, buttons, images, videos, quotes and more. Most Heirloom sections accept them, so you can add the pieces you need to a section and put them in any order.

Where you can add theme blocks

When a section’s Add block list includes theme blocks, you can add any block on this page to it. In Heirloom, that includes:

  • the Blank section and the other custom sections under Layout, Text and Storytelling
  • the Section header block at the top of most sections, such as a gallery, testimonials or a trust bar
  • the Group block, so you can nest blocks inside other blocks
  • banners, slides and promo banners, media with text, and the product, featured product, recipe, contact form and newsletter sections
  • each Column in Columns and each Tab in Tabbed content
  • the main sections of templates such as pages, blog posts, collections, search and the cart

Steps:

  1. In the theme editor sidebar, click the section or block that you want to add a block to.
  2. Click Add block, and then select a block.
  3. Change the block’s settings in the panel that opens.
  4. Click Save.

Nest blocks in a group

A Group holds other blocks and lays them out together. Use a group when you want blocks side by side inside a section, a set of blocks on a card, or a few blocks on their own color scheme. A group can hold any theme block or app block, including another group.

Steps:

  1. In the theme editor sidebar, click the section, and then click Add block.
  2. Select Group.
  3. Under the group in the sidebar, click Add block, and then select a block. Repeat for each block you want in the group.
  4. In the group’s settings, set Direction to Stacked or Side by side.
  5. Click Save.

For example, to put two buttons next to each other under a heading, add a group after the heading, set it to Side by side, and then add two Button blocks inside it.

Heading

A heading with an optional small label above it. Use it to name a section or introduce a set of blocks, such as “From the orchard” over a line of text.

  • Label above heading: A short line above the heading in quiet gray, such as New season. Small label case in Theme settings > Typography decides whether it's in capitals. Use it on one or two sections a page, where it adds something the heading doesn't. It's text, not a heading, so it doesn't change the page's outline.
  • Heading: The heading text.
  • Heading size: How large the heading looks. Extra small matches footer column headings and card titles. It doesn't change the Heading level, so you can make a small H2 or a large H3. Options: Extra small, Small, Medium, Large. Default: Medium.
  • Heading level: Use H1 once per page, usually for the first banner. Options: H1 (page title), H2, H3, H4. Default: H2.

Text

A block of formatted text, such as a paragraph about your producers, a short list or a caption. Headings, lists, quotes and tables in the text look the same as they do in your product descriptions and blog posts.

  • Text: The text. Use the toolbar to add bold, italics, links and lists.
  • Style: Body is your normal text. Subtitle is larger and uses your heading font. Caption is smaller, in a softer color. Options: Body, Subtitle, Caption. Default: Body.

Button

A link styled as a button. Use it to send customers to a collection, a page or a product. To place two buttons side by side, put them in a Group set to Side by side.

  • Button label: The text on the button. The button doesn't show while the label is blank.
  • Button link: Pick a page, collection or policy; with no link the button opens the home page.
  • Button style: Filled is your main call to action. Outline suits a second, less important button. Text link looks like an underlined link. The colors come from the color scheme of the section or group. Options: Filled, Outline, Text link. Default: Filled.

Image

One image, with an optional link and caption. Use it for a photo inside a custom section or next to text in a group.

  • Image: The image. Add alt text to the image in Shopify so customers who use screen readers know what it shows.
  • Image shape: The shape of the image's frame. Original keeps the image's own shape. Other shapes crop the image to fit, around its focal point. Options: Original, Square (1:1), Portrait (4:5), Tall (3:4), Landscape (4:3), Wide (16:9), Circle (1:1). Default: Original.
  • Image width: How wide the image can get. Full width fills the space it's in. The other sizes keep the image smaller, and the section or group's alignment places it. Options: Small, Medium, Large, Full width. Default: Full width.
  • Link: Makes the image a link.
  • Caption: A short line under the image.

Icon

One icon from Heirloom’s icon library, or your own small image. It shows plain by default, or on a tinted circle when Style is Disc. Use it next to a heading or a line of text, such as a snowflake over a note on chilled delivery.

  • Icon: The icon. Select Custom image to use your own image, or None to hide it. Learn more in The icon library. Options: None, Truck, Fast truck, Package, Cold pack, Map pin, Calendar, Clock, Bottle, Cork, Wine glass, Cocktail glass, Mug, Jar, Coffee bean, Chili, Leaf, Wheat free, Vegan, Allergen advice, Honey dipper, Flame, Snowflake, Award, Returns, Gift, Shield, Chat, Phone, Heart, Star, Recycle, Hands, Herb snips, Thermometer, Scales, Basket, Custom image. Default: Leaf.
  • Custom icon: The image used when Icon is Custom image.
  • Icon size: The size of the icon, and of its circle when Style is Disc. Options: Small, Medium, Large. Default: Medium.
  • Style: Disc sets the icon on a tinted circle. Options: Plain, Disc. Default: Plain.

The icon library

Heirloom comes with 36 line icons drawn for food and drink stores. You can use them in the Icon block and in the Icon setting of Trust item, marquee Item and timeline Step blocks:

Truck, Fast truck, Package, Cold pack, Map pin, Calendar, Clock, Bottle, Cork, Wine glass, Cocktail glass, Mug, Jar, Coffee bean, Chili, Leaf, Wheat free, Vegan, Allergen advice, Honey dipper, Flame, Snowflake, Award, Returns, Gift, Shield, Chat, Phone, Heart, Star, Recycle, Hands, Herb snips, Thermometer, Scales and Basket.

A plain icon takes the text color of the color scheme it sits on, so it matches the text around it. With Style set to Disc, the icon takes the scheme’s accent color on a tinted circle. Every Icon setting also has None, which shows no icon, and Custom image, which shows your own image at the icon’s size instead.

Video

A video that plays when customers click it. Use a video that you upload to Shopify, or a link to a YouTube or Vimeo video.

  • Video: A video from your Shopify files.
  • YouTube or Vimeo link: A YouTube or Vimeo link, used when no Shopify video is selected. Nothing loads from YouTube or Vimeo until a customer presses play.
  • Poster image: The image shown before the video plays. Without one, a Shopify video shows its own preview image, and a YouTube or Vimeo link shows a plain frame with a play button.
  • Image shape: The shape of the video's frame. Options: Original, Square (1:1), Portrait (4:5), Tall (3:4), Landscape (4:3), Wide (16:9). Default: Wide (16:9).
  • Autoplay: Plays a Shopify video on its own when it scrolls into view, muted, on a loop and without controls, with a pause button. It doesn't autoplay for customers who set their device to reduce motion, or when Enable motion is off in your theme settings. Off by default.

Quote

A quote with its source: the words, a name, a role, a photo and an optional star rating. Use it for a line from a chef, a producer or a review. It looks the same as a testimonial.

  • Text: The quote. The block doesn't show while the text is blank.
  • Name: Who said it.
  • Role: A short line under the name, such as their restaurant or their town.
  • Stars: A star rating from 1 to 5. 0 shows no stars. From 0 to 5, default 0.
  • Image: A photo of the person, shown in a circle.
  • Quote size: How large the quote reads. Small suits a quote beside other text, Medium suits a pull quote, and Large reads like a page headline. Options: Small, Medium, Large. Default: Medium.

In the theme editor, an empty quote shows a greyed sample quote and name, so you can see where it goes. The sample never shows on your online store.

Group

A group holds other blocks and lays them out stacked or side by side, as plain content or on a card. Learn how to use it in Nest blocks in a group.

When you add a group, you can start from three versions: Group (a heading and text, stacked), Row (a heading and a button, side by side) and Card (a heading, text and a button on a card).

Content

  • Link: Makes the whole group a link, for example a card that opens a collection. Buttons and links inside the group keep their own links.

Layout

  • Direction: Stacked places the blocks one under the other. Side by side places them in a row. Options: Stacked, Side by side. Default: Stacked.
  • Alignment: Where the blocks and their text sit. Match parent follows the alignment of the section the group is in, so a centered banner keeps a centered group. With Side by side, it also sets where the row sits. Groups saved with Left, Center or Right keep that choice. Options: Match parent, Left, Center, Right. Default: Match parent.
  • Vertical position: How the blocks in the row line up with each other from top to bottom, with Side by side selected. Options: Top, Middle, Bottom. Default: Middle.
  • Space between: Puts the first and last block at opposite ends of the row, such as a heading at one end and a button at the other. It shows with Side by side selected. Off by default.
  • Stack on mobile: Places the blocks one under the other on screens narrower than 750 pixels, with Side by side selected. On by default.
  • Spacing: The space between the blocks. Options: None, Small, Medium, Large. Default: Medium.
  • Style: Card draws the group on a panel with padding. Plain has no panel. Options: Plain, Card. Default: Plain.

Colors

  • Use a different color scheme: Gives the group its own color scheme instead of the section's. Off by default.
  • Color scheme: The group's colors, when Use a different color scheme is on.

A group that uses the same color scheme as its section keeps that scheme and gets a thin line around its panel, so it still reads as a card, and photos, slides and groups inside it keep their colors. Only the items of Columns and Promo tiles drop a matching scheme, because their panels already stand apart.

Highlights

A short list of features, shown as chips or as a list. Use it for qualities such as Organic, Cold pressed and Single estate.

  • Items: Separate items with commas, or connect a list metafield.
  • Display: Chips shows each item as a small rounded label. List shows the items as a list. Options: Chips, List. Default: Chips.

Divider

A line between blocks. Use it to separate parts of a section, such as an introduction and a list.

  • Style: Solid is a thin line, Dashed is a dashed line, and Ornament is two thin lines around a small diamond. Options: Solid, Dashed, Ornament. Default: Solid.
  • Width: Full spans the space it's in. Short is a short line, placed by the section or group's alignment. Options: Full, Short. Default: Full.
  • Short length: How long a short line is, from 32 to 640 pixels. It starts at 128 pixels (8rem). It shows when Width is Short. From 32px to 640px, default 128px.

To put a divider between two sections, use the Divider section.

Spacer

Extra space between blocks, on top of the usual space between them.

  • Height: How much space to add. Medium and Large grow a little on larger screens. Options: Small, Medium, Large. Default: Medium.

Custom Liquid

Your own Liquid, HTML or CSS, as a block inside a section. Every Heirloom section and block that accepts app blocks also accepts a Custom Liquid block. Use it for a code snippet from a service you use, or for a short piece of Liquid, such as a line that shows a product metafield.

  • Custom Liquid: Liquid, HTML or CSS for this block; check the page after each change.

When your code prints nothing on a page, the block takes no space on that page. To add code as a section of its own, use the Custom Liquid section.

Collapsible row

A row with a heading that customers click to show or hide more text. Use a few of them for questions and answers, or for details such as storage and allergens. Rows open and close without JavaScript.

  • Heading: The text on the row. If it's blank, the row uses the policy's title when a policy fills the row, or Details.
  • Text: What customers see when they open the row.
  • Page: Used when Text is blank, so one page can fill this row everywhere.
  • Store policy: Used when Text and Page are blank; hidden when the store has no such policy. Options: None, Shipping policy, Refund policy, Subscription policy. Default: None.
  • Open by default: Shows the row open when the page loads. Off by default.

Before and after

Two images of the same thing, with a slider that customers drag to compare them. Use it for a cut of meat before and after cooking, or a jar before and after it’s filled.

  • Before image: The first image. Customers move the slider to reveal it from the left, or from the right in right-to-left languages.
  • After image: The second image.
  • Before label: Leave blank to show “Before” in the shopper's language.
  • After label: Leave blank to show “After” in the shopper's language.
  • Image shape: The shape of the frame both images are cropped to. Use two images of the same shape and framing for the best result. Options: Square (1:1), Portrait (4:5), Tall (3:4), Landscape (4:3), Wide (16:9). Default: Landscape (4:3).

Social media icons

Links to your social media accounts, as icons. Use it in a footer, a contact page or under an About text.

  • Icon size: The size of the icons. Even at Small, each icon has a tap area of at least 44 by 44 pixels. Options: Small, Medium, Large. Default: Medium.

The links come from your theme settings, so you set them once for every place they appear. Learn more about social media settings. The block doesn’t show on your online store until at least one account is set.

Email signup

An email signup form, with a field for the email address and a button. Use it to collect newsletter subscribers anywhere, such as at the end of a blog post. The Newsletter section uses this block for its form.

  • Field label: The label of the email field. Leave it blank to use Email in each customer's language.
  • Show field label: Shows the label above the field. It's off by default, so the placeholder is the one prompt. Screen readers read the label either way. Off by default.
  • Placeholder: The gray hint inside the email field. Leave it blank to use Email address in each customer's language.
  • Button label: The text on the button. Leave it blank to show Join in each customer's language.
  • Form layout: Where the button sits. With Email and button side by side, the button moves under the field when space is narrow. Options: Email and button side by side, Email above button. Default: Email and button side by side.
  • Privacy note: A short line under the form, such as how often you send emails, with a link to your privacy policy.

Messages

  • Success message: The line shown after a customer signs up, such as a welcome note. Leave it blank to use Thanks for subscribing. in each customer's language.
  • Error message: The line shown when the address is missing or isn't valid. Leave it blank to use the standard line in each customer's language.

An empty or invalid address shows a message under the field, in your store’s language. The form checks the address before it sends it, so it works with JavaScript turned off too: the browser stops an empty address with its own message. With Email above button, the field keeps its normal height. The button takes the field’s corners and height, so the two read as one control.

Signups are added to your customers with email marketing consent. Learn more in Where signups go.

Countdown

A countdown to a date and time, such as the end of an offer or a pre-order deadline. Its settings are described with the countdown section on the Banners page.