Blog and article pages
Blog and article pages
The theme builds your blog from three sections, each tied to a template. The blog landing page uses Blog banner (the
heading area at the top) and Blog (the grid of post cards below it). A single post uses Article. Each is the main
section for its template, so you reach its settings by opening that template in the theme editor, not from Add section.
For the concepts behind sections, blocks, and content slots, see Sections, blocks, and groups.
Open the blog and article templates
1. In the theme editor, open the template switcher at the top of the screen.
2. Choose Blog to edit the blog landing page, or Article to edit a single post. Pick the blog or post you want to
preview.
3. Click a section in the sidebar to open its settings.
The blog landing page shows Blog banner at the top and Blog below it. The post page shows the Article section.
Blog banner
Blog banner is the heading area at the top of the blog landing page: breadcrumbs, a heading, and a description over a
background image. The heading and description live in a Content content slot, so you edit them as blocks under the
section, not as section settings. It is fixed to the blog page and cannot be added elsewhere.
Settings
- Section below scrolls over: on by default. The section under the banner slides up over it with rounded top corners
as the page scrolls. Turn it off and the banner scrolls away normally. It only works when the banner is at the top
of the page.
- Shadow under the next section: draws a soft shadow along the edge of the incoming section, so it reads as a separate
layer sliding over the banner. Available while Section below scrolls over is on.
Content
- Image: the background image for the banner. Leave it empty to show a placeholder fill.
- Image focus: which part of the image stays in view when the banner crops it. 0 percent holds the left edge, 100
percent the right, 50 percent the center.
- Overlay strength: how strongly the image is darkened behind the text. 0 percent leaves the photo untouched, 150
percent is the darkest setting.
- Show breadcrumbs: shows the Home and blog links above the heading. On by default.
Size
- Desktop height: the banner height on desktop, as a share of the screen height. Runs from 40 to 100 percent,
default 82.
- Mobile height: the same on phones. Runs from 40 to 100 percent, default 66.
This section also uses the standard Color controls. See Common section settings. It has no Visibility control, because
the banner is pinned to the top of the blog page.
Blog
Blog is the grid of post cards on the blog landing page. Each card pulls its image, title, date, excerpt, and category
(the post's first tag) from the post itself, so you fill the grid by publishing posts, not by adding blocks. The
eyebrow, heading, and lede above the grid live in a Header content slot, which you edit as blocks under the section.
Grid
- Posts per page: how many posts show before pagination, from 6 to 24.
- Show tag filter bar: shows a row of tag links above the grid so visitors can filter posts by tag. The bar lists the
tags used across the blog and appears only when the posts have tags.
- Editorial layout: gives the grid a mixed layout where some cards are larger than others. Turn it off to render every
card the same size.
- Pagination: how visitors move through more posts. Pages adds numbered page links. Infinite scroll loads the next
posts as the visitor reaches the bottom.
This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings.
Article
Article is the layout for a single blog post. It renders the post hero (eyebrow, title, lede, author, and date), the
post body, and an end-of-article area. The hero, body, and comment form all come from the post's own content and your
blog's comment settings, so this section exposes only the end-of-article controls.
End-of-article
- Show share buttons: shows Facebook, X, Pinterest, and copy-link buttons below the post body.
- Show author bio: shows the author's name and bio after the post. It appears only when the author has a bio filled in
on their staff account.
This section also uses the standard Color control (its Color scheme). See Common section settings.
Tips
- The category shown on each card and at the top of an article is the post's first tag alphabetically. Shopify sorts
article tags, so they cannot be reordered. To change which one shows, rename or prefix the tag you want to sort
first.
- The post comment form and comment list are controlled by your blog's comment settings in the Shopify admin (under
the blog's settings), not by the Article section. Turn comments on there and the form appears.
- To surface posts on a page that is not the blog, add Featured articles for a plain row of cards, or Articles with
slider for a swipeable row beside a heading and a link.
- The Blog banner heading and description are blocks, so you can restyle them, swap them, or add a button the same way
you would in any other section. The same applies to the eyebrow, heading, and lede above the Blog grid.