Documentation/ Sections /Blog — Discovery
Contact us
Install
03GENERAL

Blog — Discovery

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

WHAT IT DOES

Blog — Discovery

This page explains how “Blog — Discovery” 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

  • →

    Some data can come from Shopify metafields; a missing value usually hides the related element.

CONFIGURATION

Understand the settings

Featured article

Choose the main article and configure the information visible on its card.

Featured articlefeatured_article

Article search

Customize the field and button used to search the blog.

Search textsearch_placeholder
Accessible search labelsearch_label
Search buttonsearch_submit_label

Categories

Define the label and visual of the category that displays all articles.

Category titlescategories_heading
Category image Allall_image
Label Allall_label

Article metadata

Choose the editorial information displayed on the cards and adapt their labels.

Show main excerptshow_featured_excerpt
Default: disabled
Show tagsshow_article_tags
Default: enabled
Liquid date formatdate_format

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

Default: %d %B %Y
Reading time labelreading_time_label

Favorites

Customize the actions that allow you to add or remove an article from favorites.

Add to favoritesfavorite_add_label
Remove from favoritesfavorite_remove_label
Accessible tag labelarticle_tags_label

Search results

Adapt the titles, messages and commands of the results panel.

Accessible title of the sectionaccessibility_heading
Results eyebrowresults_eyebrow
Title of resultsresults_heading
Close resultsclose_results_label
Singular resultresult_singular
Plural resultsresult_plural
Text preceding the searchresult_for_label
Title without resultempty_result_heading
Text without resultempty_result_text
Text without main articleempty_featured_text

Ranking by likes

Specify the metafields that store the data used for ranking.

Metafield namespacelikes_namespace
Default: custom
Metafield keylikes_key
Default: likes_count

Spacing

Adjust the space above and below the section.

Top marginpadding_top
Default: 72 · Range: 0–140px
Bottom marginpadding_bottom
Default: 72 · Range: 0–140px

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

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

Categorycategory

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.