> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommended Products

> Display Shopify's AI-powered product recommendations to encourage cross-selling and upselling.

The Recommended Products section displays Shopify's AI-powered product recommendations based on the current product or cart contents. It shows personalized product suggestions to encourage cross-selling and upselling.

Shopify's recommendation engine analyzes purchase patterns, product relationships, and customer behavior to suggest the most relevant products, helping increase average order value and improve shopping experience.

<img src="https://mintcdn.com/digifist/XfpkuqgTixomOI7P/images/theme/release/sections/product-recommendations/product-recommendations-overview.png?fit=max&auto=format&n=XfpkuqgTixomOI7P&q=85&s=774dec12424cbaa7b402b75cd707fbf0" alt="Recommended Products section overview" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/product-recommendations-overview.png" />

## What this section controls

This section controls product recommendation displays with the following capabilities:

* Shopify AI-powered product recommendations
* Up to 12 recommended products
* Carousel-style display with navigation
* Tab-style filtering options
* Stock status visibility control
* Optional section-level button

## How the Recommended Products section works

The Recommended Products section uses Shopify's recommendation engine:

* Automatically displays related products based on current product or cart
* Supports up to 12 recommended products
* Carousel-style display with optional navigation
* Tab-style navigation for product filtering
* Configurable product visibility settings

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Add Recommended Products section">
    Add the section to a product page template or cart page.
  </Step>

  <Step title="Configure display options">
    Set maximum products, autoplay interval, and layout preferences.
  </Step>

  <Step title="Test recommendations">
    Preview on live products to verify recommendation quality.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/XfpkuqgTixomOI7P/images/theme/release/sections/product-recommendations/product-recommendations-location.png?fit=max&auto=format&n=XfpkuqgTixomOI7P&q=85&s=602fb7fbf392d7e8d4baf78f4f995539" alt="Recommended Products section in Theme Customizer" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/product-recommendations-location.png" />

## Section settings

Section settings control styling, slideshow behavior, and product display options.

<Tabs>
  <Tab title="Section styling">
    ### Layout

    Controls the visual style of the section.

    **Available options:**

    * **Layout 1:** Standard layout
    * **Layout 2:** Alternative layout

    **Default:** Layout 1

    ### Enable slideshow overflow

    Allows slideshow to overflow section boundaries.

    **Options:** True / False

    **Default:** False

    ### Section heading

    Main title text for the section.

    * Inline rich text supported (bold, italic, links)
    * **Default:** "You may also like"

    ### Heading size

    Controls the size of section heading.

    **Available options:** XS, S, M, L, XL

    **Default:** L

    ### Subheading

    Optional descriptive text above the heading.

    * Inline rich text supported

    <img src="https://mintcdn.com/digifist/ftB3AaEMznlIEX66/images/theme/release/sections/product-recommendations/section-heading.png?fit=max&auto=format&n=ftB3AaEMznlIEX66&q=85&s=bc89c006f98fffb2472fb468b189f959" alt="Section heading configuration" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/section-heading.png" />

    ### Button label

    Text for optional section-level button.

    * Leave empty to hide
    * **Default:** "View all"

    ### Button link

    Destination URL for section button.

    * Shopify URL selector

    ### Button style

    Visual style for section button.

    **Available options:**

    * **Filled:** Solid background
    * **Outlined:** Border only
    * **Text:** Text only

    **Default:** Filled
  </Tab>

  <Tab title="Slideshow & Tabs">
    ### Show navigation arrows

    Displays previous/next navigation arrows.

    **Options:** True / False

    **Default:** True

    ### Slideshow autoplay interval

    Controls automatic slide advancement.

    **Range:** 0 – 10 seconds

    * Set to `0` to disable autoplay
    * Default: 3 seconds

    <img src="https://mintcdn.com/digifist/XfpkuqgTixomOI7P/images/theme/release/sections/product-recommendations/slideshow-settings.png?fit=max&auto=format&n=XfpkuqgTixomOI7P&q=85&s=896b432969c8ba85108e96d5daf19934" alt="Slideshow configuration" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/slideshow-settings.png" />

    ### Tabs button style

    Visual style for tab navigation buttons.

    **Available options:**

    * **Filled:** Solid background
    * **Outlined:** Border only
    * **Text:** Text only

    **Default:** Filled

    <img src="https://mintcdn.com/digifist/XfpkuqgTixomOI7P/images/theme/release/sections/product-recommendations/tabs-style.png?fit=max&auto=format&n=XfpkuqgTixomOI7P&q=85&s=53925b3f99c865dfe393d05beef359d5" alt="Tab button styling" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/tabs-style.png" />
  </Tab>

  <Tab title="Products & Settings">
    ### Max products

    Maximum number of recommended products to display.

    **Range:** 4 – 12 products

    **Default:** 8

    <Note>
      Shopify's recommendation engine may return fewer products than the maximum.
    </Note>

    ### Show unavailable products

    Display products that are out of stock.

    **Options:** True / False

    **Default:** False

    <Tip>
      Enable to show all recommendations regardless of stock status.
    </Tip>

    <img src="https://mintcdn.com/digifist/ftB3AaEMznlIEX66/images/theme/release/sections/product-recommendations/products-settings.png?fit=max&auto=format&n=ftB3AaEMznlIEX66&q=85&s=5425e37c3b83b0ff936cc288eb77a5be" alt="Product display settings" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/products-settings.png" />

    ### Section width

    Controls the maximum width of the section.

    **Available options:**

    * **Page:** Standard page width
    * **Fluid:** Wider than page width

    **Default:** Page

    ### Color scheme

    Controls background and text colors for the section container.

    * Shopify color scheme selector
    * **Default:** Scheme 1

    ### Spacing top

    Controls spacing above the section.

    **Available options:** None, S, M, L, XL

    **Default:** M

    ### Spacing bottom

    Controls spacing below the section.

    **Available options:** None, S, M, L, XL

    **Default:** M

    <img src="https://mintcdn.com/digifist/ftB3AaEMznlIEX66/images/theme/release/sections/product-recommendations/section-settings.png?fit=max&auto=format&n=ftB3AaEMznlIEX66&q=85&s=cd554865631c7c3fbfa83661a8a824db" alt="Section width and spacing settings" width="3280" height="2186" data-path="images/theme/release/sections/product-recommendations/section-settings.png" />
  </Tab>
</Tabs>

## Best practices

* Place on product pages to encourage cross-selling and complementary purchases
* Use on cart page to suggest additional items before checkout
* Keep heading descriptive and action-oriented ("Complete the look", "You may also like", "Customers also bought")
* Set max products to 6-8 for optimal browsing without overwhelming customers
* Test recommendation quality - Shopify's AI improves with more order data and time
* Hide unavailable products unless showing full catalog diversity is important
* Use autoplay sparingly - consider disabling for better user control and accessibility
* Ensure sufficient historical order data for effective recommendations (at least 50-100 orders)
* Monitor recommendation performance through analytics and adjust max products accordingly
* Consider using custom collection sections if AI recommendations don't align with your merchandising strategy

## Common use cases

* **Product page upselling** - Show related or complementary products to increase average order value
* **Cart page cross-selling** - Suggest additional items before checkout to maximize basket size
* **Post-purchase recommendations** - Display related products on thank you or account pages
* **Bundle suggestions** - Encourage customers to complete product sets or collections
* **Alternative products** - Show similar products when current item is out of stock
* **Personalized shopping** - Leverage Shopify's AI to provide tailored product suggestions

## Related guides

<Card title="Common Settings" icon="sliders" href="/themes/release/common-settings">
  Learn about common settings shared across sections
</Card>
