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).
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 page.
- In the Shopify admin, go to Online Store, find your theme and click Edit theme.
- Open the page drop-down at the top (it reads Home page) and choose Blog posts, then Create template.
- Enter a name, for example “recipe”.
- Under Based on, pick the existing template to start from.
- Click Create template.
- 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.
- 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). A JSON template needs two things: a sections object and an order array (shopify.dev). This is Dawn 16.2.0’s blog post template, whole:
{
"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 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 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 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 has a free plan that shows related posts on article pages (Pro $14.99/month; 4.4 from 77 reviews). 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 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.
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. For tables of contents, see how to add one to a blog post.
Limits worth knowing
- 1,000 templates per theme, across all types.
- Templates live in the theme. The files sit in the theme’s
templatesfolder, 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 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
- You know which of the two templates you’re changing: Blogs or Blog posts.
- The new template is created in the live theme, based on the default one.
- It’s assigned to the posts or the blog that should use it.
- A long post, a short post and a post without an image all look right on a phone.
- 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.