For the complete documentation index, see llms.txt. This page is also available as Markdown.

Customize recommendation widget appearance

Rename a recommendation widget's title, switch between grid and carousel layout, and control how many products show per device.

What this does

Controls how a recommendation widget actually looks and behaves for shoppers once it's on a page — its heading text, whether products sit in a static grid or a swipeable carousel, and how many products show on desktop, tablet, and mobile. For example, switching a "Best sellers" widget from Grid to Carousel lets shoppers swipe through more products without taking up extra vertical space, which often works better on mobile, while renaming the heading to "Customer favorites" changes only what shoppers read, not which products appear.

These settings live in the Shopify theme editor, once a widget has been added to a page — see Add recommendation widgets.

Steps

  1. From the Recommendations page, click Add to theme on a widget (or open an existing one already on a page in the theme editor).

  2. In the theme editor's block settings, configure:

    • Heading — the widget's title as shown to shoppers (for example, change "Best sellers" to "Customer favorites").

    • Layout — Grid or Carousel.

    • Maximum products to show — up to 10.

    • Number of columns — set separately for desktop, tablet, and mobile.

    • Carousel options (Carousel layout only) — autoplay, infinite loop, show pagination dots, show next/previous buttons.

  3. Click Save in the theme editor.

Theme editor — recommendation widget block settings

Choosing which products a widget shows

  • The Hand-picked products widget has its own Products field in the theme editor — pick up to 12 products directly, instead of relying on automatic recommendation logic.

  • The Hand-picked related products widget has a Type setting (Related or Complementary) that chooses which set of per-product recommendations to pull from — configure those sets in Hand-pick product recommendations.

Last updated

Was this helpful?