Skip to Content
DocumentationSectionsProduct Recommendations

Product Recommendations

Display Shopify-powered product recommendations in a responsive carousel. This section uses Shopify’s recommendation engine to suggest related products based on the current product.

Configure the Section

This section is designed for the Product template. It is already included by default on product pages.

  1. Navigate to a product page in the theme editor.
  2. Click the Product recommendations section to configure it.

Section Settings

Product Display

SettingDescription
Max productsMaximum number of recommended products to show. Range: 1-10. Default: 4.
ColumnsNumber of columns on desktop. Range: 1–8. Default: 4.
Mobile card sizeSize of product cards on mobile. Large (60%) or Compact (44%). Default: Large.
Column gapSpacing between product cards. Range: 0–100px. Default: 8px.
SettingDescription
Arrow styleChevron or None. Default: Chevron.
Icon sizeArrow icon size. Range: 12–48px. Default: 20px.
Icon shapeNone or Circle background. Default: Circle.
Icon colorArrow color. Default: #666666.
Background colorArrow background color. Default: #BFBFBF.
Background opacityArrow background transparency. Range: 0–100%. Default: 20%.
Arrow placementOverlay (on top of cards) or Bottom (below cards). Default: Overlay.
Hide nav on mobileHide navigation arrows on mobile. Default: Off.

Layout

SettingDescription
Section widthPage width or Full width. Default: Page width.
Content gapSpacing between heading and product grid. Range: 0–100px. Default: 12px.
Color schemeSelect a color scheme for the section.
PaddingTop and bottom padding with unified or separate controls. Range: 0–100px. Default: 32px.

Blocks

Add text blocks for section headings, product item blocks for product-card presentation, container blocks for layout composition, and app blocks for third-party integrations.

Product item blocks can include media, title, price, swatches, and quick-add controls depending on the product-card block settings.

Empty Recommendations

Shopify recommendations can be empty for new stores, new products, products without enough activity, or products that Shopify cannot match yet. If no recommendations are available, the section stays out of the way until Shopify returns products.