---
title: "Complementary Products Module"
description: "Use Complementary Products to recommend add-ons and accessories from Shopify Search & Discovery, with setup guidance and fallback recommendations."
url: https://docs.orderediting.com/en/articles/15323532-complementary-products-module
collection: "Product Modules"
updated: 2026-09-18
language: en
---

# Complementary Products Module

Use Complementary Products to recommend add-ons and accessories from Shopify Search & Discovery, with setup guidance and fallback recommendations.

The Complementary Products module shows products that go with items in the customer's cart or order. It uses Shopify Search & Discovery complementary product data.

* * *

# When to use it

Use Complementary Products when the best offer is an add-on, accessory, or matching item.

-   Batteries for electronics.
    
-   Socks or care products for shoes.
    
-   Brushes, cases, refills, or replacement parts.
    
-   Products frequently bought together.
    

* * *

# Before you begin

Complementary Products depends on Shopify Search & Discovery. If complementary products are not configured in Shopify, the module may return no products.

**Note:** Order Editing warns you if it can't verify complementary product setup. The module can still be added, but it may not show products until Shopify has data to use.

* * *

# Setup steps

1.  Open the upsell strategy you want to edit.
    
2.  In the **Product modules** section, click **Add Module**.
    
3.  Select **Complementary Products**.
    
4.  Confirm the module is enabled.
    
5.  Set the **Recommended Quantity**.
    
6.  Write **Offer Text**, such as "Complete your order with `$productName`".
    
7.  Optional: add product filters to narrow which complementary products can appear.
    
8.  Click **Save**.
    

* * *

# Configuration options

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p class="no-margin"><strong>Option</strong></p></td><td colspan="1" rowspan="1"><p class="no-margin"><strong>What it controls</strong></p></td><td colspan="1" rowspan="1"><p class="no-margin"><strong>Recommended approach</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Enabled</p></td><td colspan="1" rowspan="1"><p class="no-margin">Whether complementary products can appear.</p></td><td colspan="1" rowspan="1"><p class="no-margin">Keep it enabled after Shopify complementary products are configured.</p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Product filters</p></td><td colspan="1" rowspan="1"><p class="no-margin">Narrows which complementary products can show.</p></td><td colspan="1" rowspan="1"><p class="no-margin">Use filters to avoid expensive add-ons on small orders.</p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Recommended Quantity</p></td><td colspan="1" rowspan="1"><p class="no-margin">The suggested add-on quantity.</p></td><td colspan="1" rowspan="1"><p class="no-margin">Use the quantity the customer realistically needs.</p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Offer Text</p></td><td colspan="1" rowspan="1"><p class="no-margin">The message that explains the product relationship.</p></td><td colspan="1" rowspan="1"><p class="no-margin">Use "pairs well with" or "complete your order" copy.</p></td></tr></tbody></table>

* * *

# Recommendations

Complementary Products works best when the customer can immediately understand why the product is useful. Keep offer text practical and specific.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p class="no-margin"><strong>Goal</strong></p></td><td colspan="1" rowspan="1"><p class="no-margin"><strong>Recommendation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Increase attachment rate</p></td><td colspan="1" rowspan="1"><p class="no-margin">Use "complete your order" or "pairs well with this" copy.</p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Avoid empty results</p></td><td colspan="1" rowspan="1"><p class="no-margin">Add a fallback module after Complementary Products.</p></td></tr><tr><td colspan="1" rowspan="1"><p class="no-margin">Protect margins</p></td><td colspan="1" rowspan="1"><p class="no-margin">Use product filters to prevent expensive add-ons from appearing on small carts.</p></td></tr></tbody></table>

## What makes a good complementary offer

A good complementary offer solves an obvious next need. The product should feel like it completes, protects, refills, or improves the purchased item.

Avoid using this module for broad discovery. If the product is simply similar, use Related Products instead.

## Recommended fallback

Add a Collection or Group of Products module after Complementary Products. This protects the strategy when Shopify doesn't return complementary products.

* * *

# Troubleshooting

## No products appear

Check that complementary products are set up in Shopify Search & Discovery for the purchased products.

## The recommendations are too broad

Review your Shopify recommendation data, then add product filters in Order Editing if you need extra control.

## Related

- [Product Modules](https://docs.orderediting.com/en/articles/14466379-product-modules.md)
- [Upsell Products from Cart Module](https://docs.orderediting.com/en/articles/15323570-upsell-products-from-cart-module.md)
- [Upsell / Downsell Module](https://docs.orderediting.com/en/articles/15323568-upsell-downsell-module.md)
- [Subscription Upsell Module](https://docs.orderediting.com/en/articles/15323559-subscription-upsell-module.md)
- [Single Product Module](https://docs.orderediting.com/en/articles/15323557-single-product-module.md)