03GENERAL

Product recommendations

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

WHAT IT DOES

Product recommendations

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

Used in templates

product.bulk.jsonproduct.jsonproduct.morning-routine.jsonproduct.night-routine.jsonproduct.subscriptions.jsonproduct.unsellable-product.json

IMPLICIT BEHAVIOR

What the theme does automatically

→
The list is calculated by Shopify from the current product and may be empty when no recommendations exist.
→
The section hides when no relevant products are returned.
→
Products come from Shopify’s recommendation engine and may vary with the viewed product.

CONFIGURATION

Understand the settings

Content

Products are calculated by Shopify and loaded only when approaching the section.

Eyebroweyebrow

Titleheading

Introductiontext

Type of recommendationsintent

Default: related · Options: Related products, Complementary products

Number of productsproducts_to_show

Default: 4 · Range: 2–4

Product cards

Media uploaded by productmedia_limit

Default: 2 · Range: 1–4

Media carouselenable_media_slider

Default: disabled

Show colorsshow_color_swatches

Default: enabled

Color option namescolor_option_names

Size option namessize_option_names

Quick Addshow_quick_add

Default: enabled

Show reviewsshow_reviews

Default: enabled

Show materialshow_material_badge

Default: enabled

Show low stockshow_low_stock

Default: enabled

Low stock thresholdlow_stock_threshold

Default: 4 · Range: 1–10

Action labels

Quick Addquick_add_label

Confirmconfirm_add_label

Loadingadding_label

Successadded_label

Unavailablesold_out_label

Errorerror_label

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

This section has no reorderable blocks. Its content is controlled by its settings and related Shopify data.

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.