Article page
A single blog post: featured image, title, body and an optional sidebar.
Where to find it: In the theme editor, choose this template from the page dropdown at the top of the screen. Template file: templates/article.json.
Good for
- Long guides and recipes that benefit from a table of contents
- Pointing readers to more posts from the sidebar
- Collecting comments on your posts
Section settings
Features
| Highlight blockquotes in side panel | Pulls every blockquote from the article into a side panel beside the content.
On by default. |
Navigation
| Show previous / next links | Adds links at the end of the post to the previous and next posts in the same blog.
On by default. |
Comments
| Enable comments | Comments must also be enabled for the blog in your store admin.
On by default. |
| Comments per page | How many comments show before readers need the page numbers to see more.
Adjustable from 1 to 20 (default 2). Only appears when Enable comments is on. |
Appearance
| Color scheme | Sets the background, text, border and button colors for the section. Schemes are defined once in Theme settings → Colors and reused everywhere, so changing a scheme updates every section using it. |
Spacing
Top and bottom spacing for desktop, with optional separate values for mobile. These are the same controls on every section. See Settings every section shares.
Blocks
Blocks are the individual pieces inside the section. In the sidebar, click Add block under the section to add one, and drag blocks to reorder them. The order in the sidebar is the order on the page.
Featured image block
Custom images
| Desktop image | Background image used on desktop.
2880 x 1280px (large) .jpg recommended. |
| Mobile image | A separate image used on mobile. Leave empty to reuse the desktop image.
1200 x 900px .jpg recommended. |
Layout
| Desktop image ratio | Image crop shape on desktop.
Choose Adapt to image, Square (1:1), Landscape (4:3), Portrait (3:4) or Wide (16:9) (default). |
| Mobile image ratio | Image crop shape on mobile.
Choose Adapt to image, Square (1:1), Landscape (4:3) (default), Portrait (3:4) or Wide (16:9). |
Title block
Layout
| Text alignment | Aligns the heading and body text left, center or right.
Default: Left. |
Article meta
| Show author | Shows the post author.
On by default. |
| Show date | Shows the publish date.
On by default. |
| Show tags | Shows the post tags.
On by default. |
Sidebar block
Layout
| Position | Which side of the post the sidebar sits on, on desktop.
Choose Left (default) or Right. |
| Enable sticky sidebar | Keeps the sidebar in view while the reader scrolls a long post, so the table of contents stays within reach.
On by default. |
Table of contents
Automatically generates navigation links from the H2 and H3 headings in your article. Add H2 or H3 headings in the article editor for this to appear.
| Show table of contents | Lists the post's H2 and H3 headings as jump links. Posts without those headings show no table of contents.
On by default. |
Featured posts
| Enable blogs navigation | Shows the posts you choose in Select articles (up to three) in the sidebar, as further reading.
On by default. |
| Heading | Heading above the featured posts list, such as "Popular posts".
Only appears when Enable blogs navigation is on. |
| Heading size | Size of the featured posts heading, from the sizes in Theme settings → Typography.
Choose Default (default), H1, H2, H3, H4, H5 or H6. |
| Select articles | Choose which posts to show, and in what order. |
Social share buttons
| Show social share buttons | Adds share buttons to the sidebar so readers can pass the post on.
On by default. |
| Heading | Heading above the social links.
Only appears when Show social share buttons is on. |
| Heading size | Size of the share heading, from the sizes in Theme settings → Typography.
Choose Default (default), H1, H2, H3, H4, H5 or H6. |
| Show Facebook | Adds a button that opens a Facebook share window with a link to the post.
On by default. Only appears when Show social share buttons is on. |
| Show X (Twitter) | Adds a button that opens a post on X with the post's link filled in.
On by default. Only appears when Show social share buttons is on. |
| Show Pinterest | Adds a button that pins the post to Pinterest.
On by default. Only appears when Show social share buttons is on. |
| Show email | Adds a button that opens the reader's email app with a link to the post.
On by default. Only appears when Show social share buttons is on. |
Tips
- Structure posts with H2 and H3 headings. The sidebar's table of contents is built from them, so a post written in plain paragraphs gets no contents list.
- Blockquotes can double as pull quotes. With Highlight blockquotes in side panel on, quotes you add in the post editor are shown beside the text.
- Pick a few evergreen posts for the sidebar's featured list; the same list shows on every post.
Troubleshooting
Comments aren't showing
Two switches must be on: Enable comments here, and comments for the blog itself in your admin (open the blog's settings under Blog posts → Manage blogs). If comments need approval, new ones appear only after you approve them.
The table of contents is empty
The post has no H2 or H3 headings. Edit the post and format your section titles as Heading 2 or Heading 3.
The featured posts list doesn't appear
It needs Enable blogs navigation on and at least one post chosen in Select articles.