Skip to main content
The Blog post template (main-article) controls how individual blog articles display on your store. It provides customization for featured images, article metadata, social sharing, and comment pagination through a flexible block system.
Blog post article overview

​
What this section controls

  • Featured image display and sizing
  • Article title with date and author
  • Article content display
  • Tag display (links or badges)
  • Back to blog navigation
  • Social media sharing buttons
  • Comment pagination
  • Third-party app integrations

​
Getting started

1

Open Theme Customizer

In your Shopify admin, go to Online Store > Themes and click Customize on your active theme.
2

Navigate to an article page

Use the page selector dropdown to select Blog posts and choose any article to preview.
3

Locate the template

The “Blog post” section controls the main article template. Additional sections can be added below it.
Blog post section location

​
Template settings

​
Block settings

Build your article page by adding and arranging blocks. Typical order: Featured Image → Title → Content → Tags.
Displays article title with optional metadata. Limit 1 per article page.Configuration:
  • Show date: Display article publish date (enabled by default)
  • Show author: Display article author name (enabled by default)
Metadata display: Date and author appear below the article title.When to show metadata:
  • Show both: Multi-author blogs, time-sensitive content, news articles
  • Date only: Single-author blogs where authorship is implied
  • Neither: Timeless evergreen content where dates may reduce perceived value
SEO note: Title automatically includes proper heading structure (H1) for search optimization.
Displays the main article content. Limit 1 per article page.No configuration needed - automatically renders full article content including:
  • Rich text formatting
  • Embedded images
  • Videos
  • Links
  • Lists and blockquotes
Content editing: Edit article content in Shopify Admin → Online Store → Blog posts → [Article].
Displays article tags as clickable links or visual badges. Limit 1 per article page.Configuration:
  • Tags type: Choose visual style:
    • Links (default): Plain text links with separators
    • Badges: Styled pill/badge buttons
Tag functionality: Tags are clickable and filter the blog to show all articles with that tag.Tag management: Add tags when creating/editing articles in Shopify admin. Tags help with:
  • Article categorization
  • Content filtering for readers
  • Internal linking and navigation
  • SEO through topical grouping
Best practices:
  • Use 3-7 tags per article
  • Create consistent tag naming conventions
  • Use badges for modern aesthetic, links for minimal design
  • Position tags at article end or near social sharing
Integration point for third-party blog apps. Unlimited blocks allowed.Common blog apps:
  • Comment systems (Disqus, Facebook Comments)
  • Related posts recommendations
  • Email subscription widgets
  • Reading time calculators
  • Table of contents generators
  • Social proof widgets
No configuration needed - apps appear automatically when installed and configured.

​
Managing blog comments

Article comments are managed through Shopify’s built-in blog comment system.
1

Enable comments

Go to Shopify Admin → Online Store → Blog posts → Manage blogs → [Your blog] → Edit.Check “Comments are” and choose moderation setting:
  • Disabled: No comments
  • Moderate: Approve before publishing
  • Published automatically: Immediate publishing
2

Moderate comments

View and manage comments at Shopify Admin → Online Store → Blog posts → Comments.You can approve, spam, or delete comments.
3

Configure pagination

Set “Comments per page” in the template settings. Lower numbers (5-10) are recommended for performance.
Comment best practices:
  • Use moderation to prevent spam
  • Respond to legitimate comments to encourage engagement
  • Monitor comments regularly for quality discussions

​
Best practices

Consistent featured images

Use the same aspect ratio across all articles (16:9 recommended). Creates cohesive visual experience and professional appearance.

Enable social sharing

Keep social sharing enabled to amplify content reach. Position after article content when readers are primed to share valuable insights.

Show metadata strategically

Show dates for time-sensitive content (news, updates). Hide dates for evergreen content to maintain perceived freshness.

Use tags effectively

Create 5-10 core topic tags and use consistently across articles. Avoid tag sprawl - consolidate similar tags (e.g., “Fashion Tips” not “fashion”, “Fashion”, “fashion-tips”).

Optimize featured images

Compress images before upload (aim for under 200KB). Use tools like TinyPNG or ImageOptim. Large images slow page load significantly.

Badge style for modern look

Use badge-style tags for contemporary design. Link-style tags suit minimalist or text-heavy blogs.

Keep back to blog button

The return navigation improves user experience and keeps readers engaged with more content. Only remove if you have custom navigation.

Moderate comments proactively

Set comments to moderated to prevent spam. Respond to genuine comments quickly to build community and encourage future engagement.

Block order matters

Standard order works best: Featured Image → Title → Content → Tags → Comments. Social sharing typically appears near content end.

Limit comments per page

Keep at 5-10 comments per page for optimal performance. Long comment threads slow page load and overwhelm readers.