Skip to main content
The Main Article template displays individual blog posts with a flexible block-based layout, controlling featured images, article metadata, content, tags, social sharing, and commenting features to create engaging blog experiences. This modular template allows you to customize the order and display of article elements like title, image, content, and tags for optimal reading experience. Use this template to publish compelling blog content that engages readers, encourages sharing, and strengthens your brand’s content marketing strategy.

​
Template Settings

​
Content Features

Display a navigation link back to the blog listing page.
  • Type: Checkbox
  • Default: Enabled
The button typically appears at the top of the article, helping readers navigate back to browse more posts.
Enable social media sharing buttons for the article.
  • Type: Checkbox
  • Default: Enabled
Typically includes:
  • Facebook
  • Twitter/X
  • Pinterest
  • Email
  • Copy link
Social sharing increases article reach and engagement. Keep enabled unless you have specific reasons to disable.
Control how many comments display before pagination.
  • Range: 2-20 comments
  • Step: 1
  • Default: 5
Lower values (5-10) keep page length manageable. Higher values (15-20) reduce pagination clicks but increase page length.

​
Layout Settings

Control the reading width of the article content.
  • Narrower (default) - Optimal for long-form reading (~650px)
  • Narrow - Slightly wider reading column (~800px)
  • Page - Standard page width (~1200px)
  • Fluid - Extends to container edges
Narrower is recommended for blog articles as it provides the most comfortable reading experience with optimal line length.
  • Select from available theme color schemes
  • Default: scheme-1
  • Top Spacing: 0, 1, 2 (default), 4, or 6
  • Bottom Spacing: 0, 1, 2 (default), 4, or 6
  • None (default)
  • Top Border
  • Bottom Border
  • Both Borders

​
Blocks

The article template uses a flexible block system to control content layout and order.

​
Title Block

Displays the article title with optional metadata.Limit: 1 per articleSettings:
  • Show Date: Display publish date (enabled by default)
  • Show Author: Display article author (enabled by default)

Date Format

Typically: “January 15, 2024” or “15 Jan 2024” depending on locale

Author Display

Shows author name set in blog post editor
Displaying date and author builds credibility and helps readers assess content freshness.

​
Content Block

Displays the main article body content.
  • Limit: 1 per article
  • No settings - automatically renders article content from blog post editor
  • Rich text support: Headings, lists, images, videos, embeds, code blocks
Content is authored in Shopify Admin → Content → Blog posts using the rich text editor.

​
Tags Block

Displays article tags for categorization and filtering.Limit: 1 per articleSettings:
  • Tag Display Type:
    • Links (default) - Clickable tags that filter blog by tag
    • Text - Static text labels (non-clickable)

Links Mode

Tags are clickable, filtering blog to show all posts with that tag

Text Mode

Tags are visual labels only, providing categorization without navigation
Tags must be added to the blog post in Shopify Admin (Blog posts → Tags field). Empty tag field = no tags displayed.

​
App Block

Supports third-party app integrations for articles.
  • Limit: Unlimited
  • Common uses:
    • Comment systems (Disqus, Commentbox)
    • Related posts widgets
    • Email subscription forms
    • Author bio boxes
    • Table of contents generators
Apps must support article page integration. Check app documentation for compatibility.

​
Block Ordering

Customize the article layout by reordering blocks in the Theme Customizer:
1

Featured Image

Visual impact at the top
2

Title

Article headline with date/author
3

Content

Main article body
4

Tags

Categorization at the end
5

App Blocks

Comments, related posts, author bio (after content)

​
Alternative Layouts

Minimal

Title → Content(No image, tags, or metadata)

Content-First

Title → Content → Featured Image → Tags(Image below content)

Full-Featured

Featured Image → Title (date + author) → Content → Tags → Social Sharing → Comments

News Style

Title (date + author) → Featured Image → Content → Tags

​
Best practices

Content writing

Use headings (H2, H3) to structure long articles, break into short paragraphs (3-5 sentences), include images throughout (not just featured image), use bullet points and numbered lists for scannability, add alt text to all images. Optimal length: 300-600 words (short), 800-1,500 (standard), or 2,000+ (long-form).

Featured image guidelines

Use minimum width of 1200px for retina displays, 16:9 or 3:2 aspect ratio, JPG (photos) or PNG (graphics), under 200KB file size. Use high-quality relevant images, avoid generic stock photos, include branding if needed, ensure subject is centered for mobile safety.

SEO optimization

Write descriptive keyword-rich titles (50-60 characters), add meta description (150-160 characters), use heading hierarchy (H2 → H3 → H4), include internal links to related articles/products, add image alt text, use 3-5 tags per post, enable social sharing. Edit URL handles for cleaner links.

Commenting strategy

Moderate comments to prevent spam (Shopify Admin → Settings → Comments), respond to legitimate comments to encourage engagement. Set 5-10 comments per page for low traffic, 10-15 for high traffic. Consider third-party systems like Disqus for better spam filtering.

Social sharing

Keep social sharing enabled on all articles, use compelling featured images for social previews, write engaging titles that encourage clicks, add Open Graph meta tags for better previews. Social previews use featured image, title, and meta description.

Tags strategy

Use 3-5 relevant tags per post consistently, create consistent tag naming (lowercase, no spaces), use tags for topics not keyword stuffing. Examples: “skincare-tips”, “summer-fashion”, “diy-tutorials”. Choose Links (default) for tag-based navigation or Text for purely informational labels. Avoid too many tags.

​
Use Cases

Company Blog

News, updates, company culture posts with author attribution

Product Guides

How-to articles, tutorials, and product education content

Lifestyle Content

Fashion lookbooks, recipes, travel guides with rich imagery

Thought Leadership

Industry insights, opinion pieces, expert commentary

Customer Stories

Testimonials, case studies, user-generated content features

SEO Content

Keyword-targeted articles to drive organic search traffic

Main Blog

Blog listing page showing all articles in reverse chronological order

Main Blog Banner

Optional banner section for blog listing pages

Blog Articles Section

Can be added to article template to show related posts

​
Advanced Enhancements

While the template provides core article functionality, enhance with additional sections:

Related Products

Add Product Recommendations section to drive sales from content

Newsletter Signup

Add Newsletter section at end of articles to capture readers

Author Bio

Use Rich Text section or app block for author information

Table of Contents

Use app blocks for long-form article navigation
Add sections to the article template in Theme Customizer: Online Store → Themes → Customize → Blog posts → Article (select any article to edit template).

​
Troubleshooting

Possible Causes:
  • No tags added to blog post
  • Tags block not added to template
Solutions:
  1. Add tags in blog post editor (Tags field)
  2. Add Tags block to article template
  3. Verify block settings (links vs text mode)
Check:
  • Comments enabled in Shopify settings (Settings → Comments → Posts)
  • Article has comments (or submit test comment)
  • Comment moderation settings (auto-approve vs manual)
New blogs start with zero comments. First comment must be approved before appearing (unless auto-approve is enabled).
Verify:
  • Social sharing is enabled in template settings
  • Browser isn’t blocking social widgets
  • Social meta tags are configured correctly
  • Test share links in incognito mode

​
Quick Summary

  • Purpose: Individual blog article display template
  • Content Source: Articles from Shopify blog posts
  • Layout: Flexible block-based system
  • Available Blocks: Featured Image, Title, Content, Tags, App blocks
  • Key Features: Social sharing, comments, back to blog navigation
  • Recommended Width: Narrower (optimal reading experience)
  • Comments: 2-20 per page (default: 5)
Articles are created in Shopify Admin → Content → Blog posts, not in the Theme Customizer. The template controls how articles are displayed, not the article content itself.