03GENERAL

Blog — Articles and Top

This page explains how “Blog — Articles and Top” actually behaves, which data it depends on, and what its settings change.

WHAT IT DOES

Blog — Articles and Top

This page explains how “Blog — Articles and Top” actually behaves, which data it depends on, and what its settings change.

Used in templates

blog.jsonblog.main-blog.json

IMPLICIT BEHAVIOR

What the theme does automatically

→
Pagination is calculated by Shopify: the section only loads the configured number of items per page.
→
Some data can come from Shopify metafields; a missing value usually hides the related element.

CONFIGURATION

Understand the settings

Section Headers

Customize the titles of the article list and Top ranking.

Eyebroweyebrow

Titleheading

Ranking eyebrowtop_eyebrow

Ranking titletop_heading

Top Ranking

Choose the source used to rank popular posts.

Classification methodtop_mode

Default: manual · Options: Manual in editor, Automatic by likes

Item grid

Set the pagination, number of columns and information visible on the cards.

Articles per pageposts_per_page

Default: 9 · Range: 6–24

Columns on desktopcolumns_desktop

Default: 3 · Range: 2–4

Show excerptsshow_excerpt

Default: enabled

Excerpt lengthexcerpt_length

Default: 150 · Range: 80–240

Show tagsshow_article_tags

Default: enabled

Show number of likesshow_likes

Default: enabled

Card labels

Adapt the date formats, counters and actions available on articles.

Date formatdate_format

Use a Liquid date format, for example %d %B %Y.

Default: %d %B %Y

Short ranking dateshort_date_format

Use a short Liquid date format, for example %d/%m.

Default: %d.%m.%Y

Reading time labelreading_time_label

Singular articlearticle_singular_label

Plural articlesarticles_plural_label

Accessible tag labelarticle_tags_label

Likes labellikes_label

Add to favoritesfavorite_add_label

Remove from favoritesfavorite_remove_label

Empty States

Customize the messages displayed when no articles or ratings are available.

Text without articleempty_articles_text

Text without manual selectionempty_manual_ranking

Ranking source

Configure the metafields used when ranking based on recorded likes.

Show metafield helpshow_metafield_note

Default: disabled

Metafield help textmetafield_note

Metafield namespacelikes_namespace

Use exactly the namespace of the metafield that stores the likes.

Default: custom

Metafield keylikes_key

Use exactly the metafield key that stores likes.

Default: likes_count

Pagination

Customize accessible labels for pagination controls.

Pagination labelpagination_label

Previous pageprevious_label

Next pagenext_label

Spacing

Adjust the space above and below the section.

Top marginpadding_top

Default: 72 · Range: 0–140px

Bottom marginpadding_bottom

Default: 104 · Range: 0–160px

Section palette

Applies a consistent palette to the background, text, and buttons in this section.

Section appearance

Use a dedicated paletteopaline_use_color_scheme

Default: disabled

Paletteopaline_color_scheme

Default: scheme-1

Title

Alignment on desktopopaline_heading_alignment

Default: inherit · Options: Keep the design, Left, Center, Right

Spacing

Space after sectionopaline_section_spacing

Creates space between this section and the next. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–160px

Left and right insetopaline_content_inset

Moves content away from the edges. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–120px

COMPOSITION

Available blocks

Top posttop_post

Add this block only when it provides useful information to the journey.

CHECKS

Before publishing

✓
Content remains readable in every color scheme.
✓
Labels match the storefront language.
✓
Displayed promotions match Shopify rules.
✓
Interactions remain accessible by keyboard and touch.