Section tutorials
Blog / Journal listing
Display a blog's published articles with pagination, optional tags and editorial card layouts.
Where to find it
Open Blogs in the template selector and choose the blog whose listing you want to preview.
Set it up
- Create and publish articles in the intended blog, including featured images and excerpts where useful.
- Choose Grid or Collage and set Posts per page and Image ratio.
- Choose which metadata and excerpt elements display, and set the read-article label.
- Enable Show tag filter only when you use useful article tags. Add Blog category blocks to link selected blogs.
- Check the listing, a tag-filtered view, pagination and a linked article.
Main settings to review
| Setting | Choices or control |
|---|
| Desktop layout | Grid · Collage |
| Posts per page | 3–24; step 1 |
| Image ratio | Wide · Square · Portrait |
| Show tag filter | On / Off |
| Show excerpt | On / Off |
| Show blog title | On / Off |
Blocks and content
- Blog category: configure this inside the section. Its available controls are listed below.
- Cards use article featured images. Keep their crops consistent with the selected ratio; around 1200–1600 px is a useful starting point for listing images.
Check the mobile layout
- Review long titles, excerpts, category links and pagination on a phone. Use a manageable page size rather than making visitors scroll through every article at once.
Common questions and fixes
- An article is absent: check its blog, publication and active page/tag filter.
- Tag links are unhelpful: tidy article tags in Shopify or turn off the tag filter.
Full control reference
Names, choices, ranges and defaults below are read from this version of the theme. Defaults are starting examples, not promises about your business. Some controls appear only for the matching layout. Block contents and preset starting values can differ from the base defaults.
All section controls (17)
| Setting | Control or choices | Default and guidance |
|---|
| Show tag filter | On / Off | Default: Off. |
| Posts per page | 3–24; step 1 | Default: 9. |
| Blog post card / Desktop layout | Grid · Collage | Default: Grid. Posts are stacked on mobile. |
| Blog post card / Image ratio | Wide · Square · Portrait | Default: Wide. |
| Blog post card / Blog card background | Choose a color | Default: #F7F7F7. |
| Blog post card / Show tags | On / Off | Default: On. |
| Blog post card / Show date | On / Off | Default: On. |
| Blog post card / Show comment count | On / Off | Default: Off. |
| Blog post card / Show author | On / Off | Default: Off. |
| Blog post card / Show excerpt | On / Off | Default: On. |
| Blog post card / Show read more | On / Off | Default: On. |
| Blog post card / Read article button label | Text | Default: Read article. |
| Section / Top padding | 0–160 px; step 4 | Default: 72. |
| Section / Bottom padding | 0–160 px; step 4 | Default: 120. |
| Section / Show section divider | On / Off | Default: Off. |
| Section / Make section full width | On / Off | Default: Off. |
| Blog header / Show blog title | On / Off | Default: On. |
Blog category block controls (2)
| Setting | Control or choices | Default and guidance |
|---|
| Blog | Choose a blog | Default: Not set. |
| Background color | Choose a color | Default: #F7F7F7. |