03GENERAL

Product collection

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

WHAT IT DOES

Product collection

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

Used in templates

index.json

IMPLICIT BEHAVIOR

What the theme does automatically

This section only displays elements that have content. Empty elements are ignored to preserve the layout.

CONFIGURATION

Understand the settings

Content and products

Add the title, intro text and products featured in the carousel.

Section titletitle

Texttext

Product selectionproduct_list

Collection to displaycollection

Takes priority over the manual product selection.

Number of collection productscollection_limit

Default: 12 · Range: 2–24

Initial centered cardinitial_card_position

Choose which card is centered when the carousel loads. Visitors can still scroll back to the first card.

Default: 1 · Range: 1–24

Full widthfull_width

Default: disabled

Product media

Adjust the number of media, carousel and behavior of videos on cards.

Number of media loaded per productmedia_limit

Default: 5 · Range: 1–8

Show arrows and media pointsenable_media_slider

Default: enabled

Product video in the cardvideo_mode

Default: poster · Options: Show cover image, Silent autoplay

Variants

Configure the color chips and option names recognized by the theme.

Show colors in pelletsshow_color_swatches

Default: enabled

Option names recognized as colorscolor_option_names

Separate with commas.

Priority source of pelletsswatch_source

Default: native_first · Options: Swatch Shopify then variant image, Variant image then swatch Shopify

Purchase

Configure purchase actions and messages displayed during add to cart.

Show quick purchaseshow_quick_add

Default: enabled

Show quantityshow_quantity_selector

Default: enabled

If the product has optionsquick_add_label

Open button textconfirm_add_label

Text while addingadding_label

Text after additionadded_label

Text unavailablesold_out_label

Error texterror_label

Universal guide

Uses the Opaline universal guide configured in the theme.

Activate guideenable_size_guide

Default: enabled

Iconsize_guide_icon

Default: question · Options: Question, Measurements, Care, Materials, Gift, Sparkle, Search, Account, Chat, Bag, Heart, View, More, Check, Star, Quiz, Look

Conversion Signals

Choose which reviews, badges, stock alerts and additional information are visible.

Show reviews if availableshow_reviews

Default: enabled

Show material badge if availableshow_material_badge

Default: enabled

Show limited stockshow_low_stock

Default: enabled

Limited stock thresholdlow_stock_threshold

Default: 4 · Range: 1–10

Show free informationshow_product_infos

Default: enabled

Number of product informationinfo_limit

Default: 3 · Range: 1–6

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

Free informationinfo

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.