Skip to main content
The Article Template (main-article) is built from a single Article section that acts as a canvas for theme blocks. The banner, title, date, body content, share buttons and comments are each separate blocks, so you can reorder, remove or restyle any part of a post without editing code. The section itself only sets the page color scheme, the gap between blocks and the common width and spacing controls. Article page on the storefront showing the banner, title, body content and share row

​
What this template controls

  • Which article blocks appear and in what order.
  • The banner that pairs the featured image with the tags, title, description and author line.
  • The reading width of the body content, share row and comments, independently of the section width.
  • Whether readers can share the post and leave comments, and how many comments load per page.
  • The page color scheme and the spacing between blocks.
  • Additional theme blocks or app blocks placed anywhere in the post.

​
Getting started

1

Open the Theme Customizer

From your Shopify admin go to Online Store, then Themes, and click Customize on Olympus.
2

Choose the article template

Use the page selector at the top of the Theme Customizer, open Blog posts and pick Default article. A sample article is loaded so you can see every block with real content.
3

Select the Article section

Click Article in the left sidebar. Its blocks are listed underneath; click any block to edit it, or drag blocks to reorder them.
Article section and its blocks selected in the Theme Customizer sidebar

​
How it works

The section stacks its blocks vertically in the order shown in the sidebar. Out of the box the order is Article banner (which nests Article tags, Article title, Article description and Date and author), then Article content. Breadcrumbs, Share and Comments are available to add from the block picker. Because the Article section accepts any theme block, you can also drop in a Heading, Text, Button, Image, Video or Group block, and any app block that supports articles.
The article itself (text, featured image, excerpt, tags, author) is written in the Shopify admin under Content, then Blog posts. The template only controls how those fields are displayed.

​
Settings

Page color scheme: The scheme applied to the whole article page. Default: Scheme 1. Individual blocks such as the banner can override it with their own scheme. Spacing between blocks: The vertical gap between consecutive blocks, from 0 to 96 pixels in steps of 4. Default: 0. Increase it when you use several stand-alone blocks; leave it low when blocks carry their own Bottom spacing.

​
Common settings

Page, Narrow, Fluid or Full width. Default: Page. Content-heavy blocks (Article content, Share, Comments) have their own Width setting so the banner can stay wide while the text stays narrow.
None, Small, Medium or Large. Defaults: Medium on top and Large at the bottom.
None, Top, Bottom or Top and bottom. Default: None.
See Common settings for how these controls behave across the theme.

​
Blocks

Every article block offers a Bottom spacing setting that adds extra space under that block on top of the section’s own gap. The header blocks use the block spacing scale (No, S, M, L, XL); the wider blocks use the section spacing scale (None, Small, Medium, Large).
The header blocks introduce the post: a breadcrumb trail and a banner that frames the title area.
A full-width card that pairs an image with a column of nested blocks. It accepts any theme block, and the default template nests Article tags, Article title, Article description and Date and author inside it.
  • Show image: Shows or hides the image half. Default: on.
  • Image: Optional override; leave blank to use the post’s featured image. Appears only when Show image is on.
  • Image position: Left or Right of the text column. Default: Left. Appears only when Show image is on.
  • Content alignment: Left, center or right alignment of the nested blocks. Default: Center.
  • Minimum height: 360 to 720 pixels in steps of 20. Default: 500.
  • Spacing between blocks: Gap between the nested blocks, 0 to 48 pixels. Default: 16.
  • Color scheme: Paints the banner card. Default: Scheme 2.
  • Bottom spacing: None, Small, Medium or Large. Default: None.
Shows the post’s tags as small labels. Maximum tags limits how many appear, from 1 to 6 (Default: 3). Size is Extra small, Small or Body (Default: Small).
The post title. Size chooses the visual size from Body up to Heading 1 (Default: Heading 1). Heading level sets the semantic level, H1, H2 or H3, for accessibility and SEO independently of the visual size (Default: H1). Keep one H1 per page.
The post excerpt. Size is Small, Body or Heading 6 (Default: Body). Fall back to the post content shows the opening words of the body when the post has no excerpt (Default: on), so the banner never looks empty.
A single meta line. Show date and Show author toggle each part (both on by default). Size is Extra small, Small or Body (Default: Small).

​
Best practices

Keep the body narrow

Leave Article content at Narrower. Shorter lines are easier to read, and the banner above still fills the page width.

One H1 per page

Keep the Article title at Heading level H1 and give any extra Heading blocks H2 or lower so search engines read the structure correctly.

Always fill the excerpt

Write a real excerpt in the admin. The fallback to post content works, but a deliberate summary reads better in the banner and on blog cards.

Place Share after the content

Readers share once they have finished. Put the Share block directly under Article content and keep its width matched.

Moderate comments

Enable moderation in the Shopify admin before turning on the comment form so spam never appears publicly.

Add related posts as a section

Use a Featured articles section below the Article section instead of a block; it keeps the post layout clean and can be reused on other templates.

Blog Template (main-blog)

Configure the listing page that links to your articles

Theme blocks

Reference for the Heading, Text, Button, Image, Video and Group blocks

Featured articles

Show related or recent posts below an article