03GENERAL

List of collections

This page explains how “List of collections” actually behaves, which data it depends on, and what its settings change.

WHAT IT DOES

List of collections

This page explains how “List of collections” actually behaves, which data it depends on, and what its settings change.

Used in templates

list-collections.json

IMPLICIT BEHAVIOR

What the theme does automatically

→
Pagination is calculated by Shopify: the section only loads the configured number of items per page.

CONFIGURATION

Understand the settings

Introductory content

Customize the eyebrow, title and text placed before the list.

Eyebroweyebrow

Titleheading

Introductionintroduction

Collection grid

Set the pagination, number of columns and image framing.

Collections to excludeexcluded_collections

These collections are hidden even when they belong to the selected list or the automatic collection list.

Collections per pagecollections_per_page

Default: 12 · Range: 6–30

Columns on desktopcolumns_desktop

Default: 3 · Range: 2–4

Columns on mobilecolumns_mobile

Default: 1 · Options: 1, 2

Image formatimage_ratio

Default: 4 / 5 · Options: Square, Portrait, Landscape

Card information

Choose the information displayed on each collection.

Show number of productsshow_product_count

Default: enabled

Show descriptionsshow_description

Default: disabled

System texts

Adapt the quantity, empty state and pagination labels.

Product labelproduct_label

Text without collectionempty_text

Pagination labelpagination_label

Spacing

Adjust the space above and below the section.

Top marginpadding_top

Default: 72 · Range: 0–120px

Bottom marginpadding_bottom

Default: 88 · Range: 0–120px

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

section-headingsection-heading

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.