HeirloomHelp CenterContact support

Blogs and recipes

Heirloom shows the blogs and blog posts that you write in your Shopify admin. The blog page lists your posts in a grid, each blog post page is laid out for reading, and the recipe template turns a post into a recipe with ingredients, a method and the products to cook it with.

You write blogs and blog posts in your Shopify admin, from Content > Blog posts. Learn more about blogs in Shopify’s Help Center.

Blog page

The blog page shows the blog’s title, then its posts in a grid with pagination. Each post shows its featured image and title, then one quiet line with the date, author and reading time, then the excerpt and up to three tags. When a post has no excerpt, the start of its content is shown instead.

The blog page uses the Blog section, which holds the Blog posts grid. You can add blocks above the grid, such as a short introduction to your journal.

You can add these blocks above the grid:

  • Theme blocks, such as Heading, Text, Button and Image
  • App blocks from apps you install

Blog settings

  • Color scheme: The colors of the blog page.
  • Vertical padding: The space above and below the blog page. Options: None, Small, Medium, Large. Default: Medium.

Blog posts grid settings

To change the grid, click Blog posts inside the Blog section in the theme editor.

Content

  • Show tag filter: Shows a link for each tag on this blog. On by default.
  • Tags shown: How many tags show as tabs in the tag filter. The rest wait behind a Show more tab, so a blog with many tags keeps one row, which swipes sideways on a phone. On a page filtered by one of the hidden tags, they all show. From 2 to 30, default 6.
  • All posts label: The first tag tab; blank uses "All posts".
  • Show article count: Shows how many posts the blog has, above the grid. It starts off. Off by default.
  • Show published date: Shows the date each post was published. On by default.
  • Show author: Shows the author of each post. It starts off in a new blog posts grid. Off by default.
  • Show reading time: Shows an estimate of how long each post takes to read. On by default.
  • Show excerpt: Shows the post's excerpt, or the start of its content when the excerpt is blank. On by default.
  • Show tags: Shows up to three of each post's tags. Each tag links to the blog's posts with that tag. It starts off. Off by default.
  • Show read more link: Shows a link to the post under each card. It starts off, because the title already links to the post. Read more label renames it. Off by default.
  • Read more label: Leave blank to use "Read more".

Media

  • Show image: Shows each post's featured image. On by default.
  • Image shape: The shape of the images. Original keeps each image's own shape, and the others crop every image to the same shape. Options: Original, Square (1:1), Portrait (4:5), Landscape (4:3), Wide (16:9). Default: Wide (16:9).

Layout

  • Columns on desktop: How many posts sit in a row on wide screens. Medium screens show two. From 2 to 4, default 3.
  • Columns on mobile: How many posts sit in a row on phones. Options: 1, 2. Default: 1.
  • Articles per page: How many posts show before the page links to the next page of posts. From 3 to 24, default 10.
  • Feature the newest post: On the first page, the newest post spans two columns. On by default.

A new blog page shows the date, reading time and excerpt of each post, with the tag filter above the grid. On the first page, the newest post spans two columns with a larger title, until you turn off Feature the newest post. Turn on the author, tags, Read more link or post count when you want them. All posts label renames the first tag tab.

Tags and empty pages

  • When Show tag filter is on, customers can click a tag to see only the posts with that tag. The page shows which tag is applied, with a link to clear it.
  • A blog with no published posts shows a short message with a link to your home page.
  • A tag with no posts shows a message with a link back to all posts.

Tags and pages are ordinary links, so they work in any browser.

Blog post page

A blog post page shows the post’s header, its content, then a footer with tags, sharing links, the author’s bio and a link back to the blog. The bio comes from the author’s staff account in your Shopify admin, and it shows only when that account has a bio. When comments are turned on for the blog, the comments follow.

The post uses the Article section. Its header, footer and comments are blocks with their own settings, and you can add your own blocks after the post content, such as a button to a collection.

You can add these blocks after the post content:

  • Theme blocks, such as Heading, Text, Button and Image
  • App blocks from apps you install

Article settings

  • Show table of contents: Lists the article's main headings when it has three or more. On by default.
  • Table of contents heading: Leave blank to use "Contents".

Media

  • Show image: Shows the post's featured image. On by default.
  • Image position: Puts the image above or below the post's title and details. Options: Below title, Above title. Default: Below title.
  • Image shape: The image's shape. Original keeps the shape you uploaded, and the others crop it to fit. Options: Original, Square (1:1), Landscape (4:3), Wide (16:9). Default: Original.

Layout

  • Content width: How wide the post's text can get. Narrow gives the shortest lines, for easy reading. Options: Narrow, Standard, Wide. Default: Standard.

Section style

  • Color scheme: The colors of the post.
  • Vertical padding: The space above and below the post. Options: None, Small, Medium, Large. Default: Medium.

With Show table of contents on, a table of contents, which you can rename with Table of contents heading, lists the post’s Heading 2 headings, so customers can jump to a part of a long post. It shows only on posts with at least three of them. On wide screens it sits in a column beside the post, level with the title, and stays in view as customers scroll. It appears from about 62 rem wide (the width depends on Content width). On smaller screens, it’s a list that customers open above the post. On any screen, it marks the part of the post that customers are reading as they scroll. The hero image stays within the text column, and the breadcrumbs and comments line up with the text. Blog, article and page titles follow the same heading scale as the rest of your store.

Article header settings

  • Show blog name link: Shows the blog's name above the post title, as a link back to the blog. It starts off, because the breadcrumbs already link back to the blog. Off by default.
  • Label above heading: A short line above the post title, such as Recipe or Field notes. It shows when Show blog name link is off.
  • Show published date: Shows the date the post was published. On by default.
  • Show author: Shows the post's author. On by default.
  • Show reading time: Shows an estimate of how long the post takes to read, based on its length. On by default.
  • Show excerpt: Shows the post's excerpt under the title, when it has one. On by default.
  • Show recipe link: Links to the recipe section on this page, when it has one. Off by default.
  • Recipe link label: Leave blank to use "Jump to recipe".

With the recipe link on, Recipe link label renames the button that jumps to the recipe.

Article footer settings

  • Show tags: Shows the post's tags as a line of text links. Each tag links to the blog's posts with that tag. On by default.
  • Show share actions: Shows links to share the post by email, Facebook, X and Pinterest. On devices with a share menu, customers get that menu instead, and a Copy link button where the browser allows it. On by default.
  • Share label: Leave blank to use "Share".
  • Show author bio: Uses the bio on the author's staff account and hides when it is blank. On by default.
  • Author heading: Leave blank to use "About the author".
  • Show back to blog link: Shows a link back to the blog at the end of the post. On by default.
  • Back link label: Leave blank to use "Back to" and the blog name.

Share label, Author heading and Back link label reword the text in this block. A blank one uses the standard wording in each customer’s language.

Comments

Comments show on a blog post only when comments are turned on for its blog in your Shopify admin. Customers see the number of comments, the comments themselves with pagination, and a form to add their own. When comments need your approval, customers see a note that their comment appears after review.

  • Comments per page: How many comments show before the list links to the next page of comments. From 5 to 50, default 10.

Steps:

  1. From your Shopify admin, go to Content > Blog posts.
  2. Click Manage blogs, and then click the blog.
  3. In the Comments section, select an option.
  4. Click Save.

Learn more about managing comments in Shopify’s Help Center.

Recipe posts

The recipe template is a blog post template for recipes. It shows the post, then a Recipe section with the recipe’s name, photo, introduction, yield, times, ingredients and method, then a featured collection called What we cooked with and more posts from the blog.

Differences from the default blog post template:

  • Show recipe link is on in the article header, so customers can jump straight to the recipe.
  • The Recipe section ships empty, and an empty recipe shows nothing on the post. To use it, fill in the recipe in the theme editor, or connect it to blog post metafields as described below.
  • The Comments block is hidden. To show comments on recipe posts, show the block in the theme editor.
  • The What we cooked with row shows all your products. To feature the products used in your recipe, such as the oil, vinegar and salt, set Products from to Chosen products and pick them.

Learn more about the Recipe section and its settings.

Give each post its own recipe

A template is shared by every post that uses it. If you type a recipe into the Recipe section’s settings, every recipe post shows that same recipe. To give each post its own recipe, store the recipe in blog post metafields, and connect the section’s settings to them.

Steps:

  1. In your Shopify admin, create blog post metafield definitions for the parts of your recipe, such as ingredients and method as rich text, and prep, cook and total time as numbers.
  2. Open each recipe post in your Shopify admin, fill in its metafields, and then click Save.
  3. From your Shopify admin, go to Online Store > Themes.
  4. Find Heirloom, and then click Edit theme.
  5. From the page selector at the top of the theme editor, select Blog posts, and then select recipe.
  6. Click the Recipe section.
  7. Next to a setting, such as Ingredients, click the Connect dynamic source icon, and then select the matching metafield.
  8. Repeat for each setting that you want to fill from the post, and then click Save.

Learn more about metafields in Heirloom.

Write ingredients and the method as lists

Enter the ingredients as a bulleted list, with one ingredient per item, and the method as a numbered list, with one step per item. The section shows them as lists, and search engines read each list item as one ingredient or one step.

Enter times in whole minutes, such as 20. Heirloom shows them in the customer’s language.

Jump to the recipe

When Show recipe link is on in the article header, a Jump to recipe button in the post’s header takes customers straight to the recipe. The button shows only on posts where the Recipe section has content, so you can leave it on for every post that uses the template.

Recipe facts

The Recipe facts block shows a recipe’s yield, prep, cook and total times anywhere that theme blocks are allowed, in the same style as the facts in the Recipe section. Use it to show the facts near the top of a post, or on a product page for a recipe kit. Its settings can connect to metafields too. Learn more about the Recipe facts block.

Recipe structured data

Heirloom adds recipe structured data to recipe posts, so search engines can understand your recipes and may show them as recipe results. The data comes from the Recipe section only, and is linked to the blog post it belongs to.

The data is added only when the recipe has all of these:

  • a recipe name, from the section’s Heading
  • an image, from the section’s Image or, when that’s blank, the post’s featured image
  • ingredients entered as a bulleted list
  • a method entered as a numbered list

Yield, prep time, cook time, total time and the introduction are added when they’re filled in. Everything in the data also shows on the page.

The Recipe facts block doesn’t add structured data, so a page never describes the same recipe twice.