# Shopify blog templates: what they control, how to make one, and what to put in it (2026)
Canonical: https://ahoiapps.com/guides/shopify-blog-templates/
Updated: 2026-11-17 by the Ahoi Apps team

> A Shopify theme has two blog templates: one for the blog page (the list of posts) and one for a blog post. You can copy either in the theme editor, change the copy and assign it to a blog or to single posts, so recipes can look different from news. No download and no app needed. Apps come in when you want a block the theme lacks, such as a table of contents, a read time or a tag filter.

## What's the difference between the blog template and the blog post template?

They belong to two different pages.

| Page | What it shows | Template in the theme editor | Default section | File in the theme |
| --- | --- | --- | --- | --- |
| Blog page, such as `/blogs/news` | Links to all the posts in that blog | Blogs | Blog posts | `templates/blog.json` |
| Blog post | One post, in full | Blog posts | Blog post | `templates/article.json` |

The names in the last column are worth knowing once: theme files call a post an "article". Everywhere else, Shopify says blog post ([Shopify Help Center](https://help.shopify.com/en/manual/online-store/themes/theme-structure/templates)).

A change to a template applies to every page that uses it. Edit the default Blog posts template and all your posts change. To make only some posts look different, you create a second template.

## How to create a blog post template in the theme editor

These are the steps from Shopify's [advanced publishing](https://help.shopify.com/en/manual/online-store/blogs/publishing-blogs) page.

1. In the Shopify admin, go to Online Store, find your theme and click Edit theme.
2. Open the page drop-down at the top (it reads Home page) and choose Blog posts, then Create template.
3. Enter a name, for example "recipe".
4. Under Based on, pick the existing template to start from.
5. Click Create template.
6. Add, remove, hide or reorder sections and blocks, then click Save.

The copy starts with the same sections as the original. When we duplicated a blog post template on our test store on 17 Nov 2026, the app blocks came along too, with their settings.

For the blog page, the steps are the same under Blogs instead of Blog posts.

## How to assign a template to a post or a blog

Creating a template changes nothing yet. You assign it in the admin:

- **A post:** Content › Blog posts, open the post, and in the Online store section pick the template under Theme template. Save.
- **A blog page:** Content › Blog posts, click Manage blogs, open the blog, and pick the template under Theme template. Save.

Two things to know. The menu lists only templates from your current live theme. And one template can serve as many posts as you like; posts with the same template display in the same style.

## What a good blog post template includes

This is our recommendation, not a Shopify rule.

- **Title and date,** so readers can tell how fresh a post is.
- **A featured image,** because the blog page shows it next to the title. Sizes are in [Shopify blog image size](https://ahoiapps.com/guides/shopify-blog-image-size/).
- **The post body at a readable width.** Long lines tire people out.
- **A table of contents on long posts,** so readers can jump to their question.
- **A read time,** which sets expectations before the first paragraph.
- **Share links,** if your readers share.
- **Related posts or products,** so the post isn't a dead end.
- **A way back to the blog.**

What Dawn, Shopify's free reference theme, gives you in version 16.2.0: the Blog post section has four blocks (Featured image, Title, Share, Content) and accepts app blocks. The Title block has checkboxes for Date, on by default, and Author, off by default. A link back to the blog is built in, and comments appear when the blog allows them. Dawn has no table of contents, no read time, no tag list and no related posts. Its Blog posts section can be added below a post, but it shows the latest posts of a blog you choose, not posts on the same topic.

## Three ways to change a template

### 1. The theme editor, no code

Add, hide and reorder sections and blocks. This covers most needs: a banner above recipes, a newsletter form below guides, the author line switched off for news.

### 2. Theme code

Templates are JSON files in the theme's `templates` folder. A second blog post template is a file named after the pattern `article.{name}.json`, for example `article.recipe.json` ([shopify.dev](https://shopify.dev/docs/storefronts/themes/architecture/templates/alternate-templates)). A JSON template needs two things: a `sections` object and an `order` array ([shopify.dev](https://shopify.dev/docs/storefronts/themes/architecture/templates/json-templates)). This is Dawn 16.2.0's blog post template, whole:

`templates/article.json`:

```json
{
  "sections": {
    "main": {
      "type": "main-article",
      "blocks": {
        "featured_image": {
          "type": "featured_image",
          "settings": {
            "image_height": "adapt"
          }
        },
        "title": {
          "type": "title",
          "settings": {
            "blog_show_date": true,
            "blog_show_author": false
          }
        },
        "share": {
          "type": "share",
          "settings": {
            "share_label": "Share"
          }
        },
        "content": {
          "type": "content"
        }
      },
      "block_order": [
        "featured_image",
        "title",
        "share",
        "content"
      ]
    }
  },
  "order": [
    "main"
  ]
}
```

The template only lists sections. The HTML and Liquid live in the section it names, here `sections/main-article.liquid`. A JSON template can render up to 25 sections with up to 50 blocks each.

Duplicate the theme before you edit code. If you'd rather not, write to service@ahoiapps.com with your theme's name.

### 3. App blocks

For things the theme has no block for. Facts are from each app's Shopify App Store listing on 17 Nov 2026.

Ours, each added as an app block:

- [Auto TOC: Blog SEO & Nav](https://ahoiapps.com/apps/ahoi-apps-table-of-contents/) builds a table of contents from a post's headings: free plan, paid from $1.99/month. **Limits, honestly:** it reads the headings a post has and can't create them.
- [Ahoi Apps: Estimated Read Time](https://ahoiapps.com/apps/ahoi-apps-estimated-read-time/) adds a read time and an optional progress bar: from $1.99/month, 7-day free trial. **Limits, honestly:** the time is an estimate from the text, and the app needs an Online Store 2.0 theme.
- [Ahoi Apps: Blog Filter & Search](https://ahoiapps.com/apps/ahoi-apps-blog-filter-search/) adds tag filters and a search: from $3.99/month, 7-day free trial. **Limits, honestly:** it belongs on the blog page template, not on the post template.

For jobs we don't cover:

- **Related posts:** [Related Posts: Digital Darts](https://apps.shopify.com/related-blog-posts) has a free plan that shows related posts on article pages (Pro $14.99/month; 4.4 from 77 reviews). [Better Related Blog Posts](https://apps.shopify.com/better-related-blog-posts) starts at $4.90/month with a 7-day trial and has no reviews yet.
- **Page-builder layouts:** [Bloggle: SEO Blog Builder](https://apps.shopify.com/bloggle) starts at $19.90/month with a 14-day trial (4.9 from 339 reviews). It brings its own drag-and-drop editor and blog designs.

More options per job are in [best blog apps for Shopify](https://ahoiapps.com/compare/shopify-blog-apps/).

## Templates by type of post

Our suggestions, to adapt.

| Type | Show | Hide or skip |
| --- | --- | --- |
| Recipe | Large image, the recipe card near the top, products used | Share buttons above the ingredients, long intros |
| Guide or how-to | Table of contents, read time, related guides | Author line if it adds nothing |
| News or announcement | Date, a short body, one link to the product or collection | Table of contents, read time |
| Lookbook | Large images, product links under each look | Read time, comments |

For recipes, the template is half the job; the other half is in [how to add recipes to Shopify](https://ahoiapps.com/guides/shopify-recipe-pages/). For tables of contents, see [how to add one to a blog post](https://ahoiapps.com/guides/shopify-blog-table-of-contents/).

## Limits worth knowing

- **1,000 templates per theme,** across all types.
- **Templates live in the theme.** The files sit in the theme's `templates` folder, and the admin menu offers only the templates of the live theme. Before you switch themes, note which custom templates you rely on.
- **Deleting and renaming happen in Edit code,** not in the theme editor. When you delete a template, its posts show with the default template until you assign another.
- **Canvas themes can't take app blocks yet.** If you design in Shopify's Canvas, read [Canvas and app blocks](https://ahoiapps.com/blog/shopify-canvas-app-blocks/) first.

## Mistakes we see most

- **Building the template in an unpublished theme,** then not finding it in the admin menu. The menu shows the live theme's templates only.
- **Editing the default template** when only some posts should change. Every post follows.
- **One template per post.** Templates are for kinds of posts.
- **Pasting layout HTML into every post.** The next redesign means editing each post by hand. Put layout in the template and content in the post.

## Checklist

1. You know which of the two templates you're changing: Blogs or Blog posts.
2. The new template is created in the live theme, based on the default one.
3. It's assigned to the posts or the blog that should use it.
4. A long post, a short post and a post without an image all look right on a phone.
5. App blocks you rely on are present in the new template.

That's the layout side. How the blog works as a whole is in [blogging on Shopify](https://ahoiapps.com/guides/shopify-blog/).

## FAQ

### How do I create a custom blog post template in Shopify?

In the admin, go to Online Store and click Edit theme. Open the page drop-down at the top, choose Blog posts, then Create template. Name it, pick an existing template under Based on, and click Create template. Change its sections and save. Then pick it on each post under Theme template.

### Where are Shopify's blog template settings?

In two places. You design a template in the theme editor (Online Store › Edit theme, then Blogs or Blog posts in the page drop-down). You choose which template a post or blog uses in the admin, under Content › Blog posts, in the Theme template menu.

### Are there free Shopify blog templates?

Yes, and you already have them. Every theme has a default template for blogs and one for blog posts, and you can create more from them at no cost. There is nothing to download. Paid themes and blog builder apps offer more layouts.

### Can I use a different template for each blog post?

You can assign a template per post, but you shouldn't build one per post. Templates are meant to be shared: one for recipes, one for guides, one for news. A theme can hold up to 1,000 templates in total.

### How do I add related posts to a Shopify blog template?

Check your theme first; some have a related posts section. Dawn doesn't, but its Blog posts section can be added below a post to show the latest posts from a blog you pick. For posts matched by topic you need theme code or a related posts app.

### Can I edit the blog template code (Liquid)?

Yes. In Online Store, open the menu next to your theme and click Edit code. The templates are templates/article.json and templates/blog.json; the Liquid is in the sections they reference, in Dawn sections/main-article.liquid and sections/main-blog.liquid. Duplicate the theme first.
