Skip to main content

Complementary Products Section

Use this section to display complementary product recommendations that work well together with the current product.

This section requires the Search & Discovery app to select complementary products and is specifically designed for product template pages.


Set up a Complementary Products section

  1. Go to Customize theme
  2. In Theme editor, select a product template page
  3. Select "Add section""Complementary Products"
Search & Discovery Required

This section is only available on product template pages and requires the Search & Discovery app for full functionality.


Configuration Settings

Setting nameDescription
TitleEnter heading text for the section. Default is "Pair it with"
Title AlignmentPosition the title left or right. Default is left
Title SizeChoose text size from S to 7XL, with responsive options. Default is "text-base"
Product DisplayChoose between "Grid" or "Carousel" layout. Default is grid
Number of productsSet how many complementary products to show (2-10). Default is 10
Products per rowFor grid layout, choose 2-5 products per row. Default is 5
Products Per Row (Mobile)Choose 1 or 2 products per row on mobile. Default is 2
Vertical spacingSet space between product rows (0-100px). Default is 20px
Horizontal spacingSet space between products (0-100px). Default is 20px
Navigation StyleFor carousel layout, choose between "Arrows" or "Text Labels". Default is arrows
Horizontal Spacing SizeChoose "None" or "Small" padding between products. Default is none
Add outer GapEnable to add padding around the entire section. Default is false

Best Practices

  • Use Search & Discovery app to curate complementary products
  • Limit to 4-6 products for best mobile experience
  • Choose products that genuinely complement the main product
  • Test on mobile to ensure carousel navigation works smoothly
Upsell Strategy

Choose complementary products with similar or slightly lower price points. High-priced additions can overwhelm customers and reduce conversion.

Placeholder Products

When no complementary products are found, placeholder products will be shown while customizing your theme. The section will not display on the live site if no complementary products exist.