> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.omegatheme.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Cart recommendation

# Cart recommendation

Use Cart recommendation to surface the right product inside the cart drawer, so shoppers reach the next discount tier without leaving the page.

## In this article
* [How it works](#2-how-it-works)
* [Before you begin](#2-before-you-begin)
* [Enable Cart recommendation](#2-enable-cart-recommendation)
* [Configure Cart recommendation](#2-configure-cart-recommendation)
* [Limitations](#2-limitations)

## How it works

Cart recommendation reads the campaigns a shopper's cart items belong to, then suggests the product most likely to unlock the next discount tier. The logic is campaign-aware, not generic cross-sell.

| Campaign type | What gets recommended |
| ---- |
| Quantity Breaks, One Discount, Buy X Get Y (quantity-based) | Products that push the cart toward the next tier. No discount yet, suggest tier 1. Tier 1 reached, suggest tier 2. |
| Order Discount (value-based) | A product whose price is closest to the remaining amount needed to unlock the next tier. |
| Product Bundle, Bought Together | The missing product(s) needed to complete the bundle. If the cart has none of the bundle items, the full bundle is suggested. |

If multiple products in the cart belong to different campaigns, the widget cycles through recommendations so the shopper always sees something actionable.

## Before you begin
* Create at least one active campaign in **Campaigns**. Cart recommendation only works with live campaigns.
* Stores on the **Basic plan or higher** can run more than one campaign at once. For best results, keep **3 to 4 campaigns** active so the engine has enough variety to work with.

## Enable Cart recommendation

1. Go to **Boost Conversion**.
2. Find the **Cart recommendation** card and click **Customize**.
3. Turn on **Show product recommendations in cart**.
4. Copy the snippet:
```html
   <div class="pareto-cart_rcm"></div>
```
5. Paste the snippet into your cart drawer where you want the widget to appear. This works with any Shopify theme and any cart drawer app.
6. Click **Save**.

![Cart recommendation widget showing product suggestions in the cart drawer](https://storage.crisp.chat/users/helpdesk/website/-/8/3/8/3/8383e5404a31c000/cart-recommendation_1mm9eqt.png)


## Configure Cart recommendation
### Campaign settings
Use **Search campaign** to pick which campaigns feed the recommendation engine. You can select up to **10 active campaigns**.

### Rule settings
Choose how products are selected:

| Rule | Description |
| ---- |
| AI Recommendation | Pareto's engine picks the number of recommendation cards based on tier logic (recommended). |
| Fixed number of products | Show a set maximum number of products you define. Set **No. of related products shown** (default `3`). |

### Display settings
| Setting | Description |
| ---- |
| Section title | Heading above the widget. Default: `Special deals for you` |
| Button text | CTA label on each recommendation card. Default: `Add` |
| Button radius size | Corner radius in pixels. Default: `8` |
| Section title color | Color of the heading |
| Button color | Background color of the Add button |
| Button text color | Text color on the Add button |

### Advanced settings
Customize the offer badge shown on each recommended product. Each campaign type has its own badge group.

**Quantity breaks, Bundles, Frequently bought together, Add-ons**
| Setting | Description |
| ---- |
| Badge label | Text shown on the badge. Supports `{{discount}}` variable. Default: `Get {{discount}} off` |
| Background color | Badge background. Default: `#DBEAFE` |
| Text color | Badge text color. Default: `#000000` |

![](https://storage.crisp.chat/users/helpdesk/website/-/8/3/8/3/8383e5404a31c000/offer-recommend_fbrrbi.png)
**Buy X Get Y**
Two badges: one for the gift, one for the discounted product.
| Setting | Description |
| ---- |
| Badge for gift | Default: `Get a free gift` |
| Badge for discounted product | Default: `Get these products discounted` |
| Background color | Default: `#DBEAFE` |
| Text color | Default: `#000000` |

![Cart recommendation badge for Buy X Get Y campaign showing free gift offer](https://storage.crisp.chat/users/helpdesk/website/-/8/3/8/3/8383e5404a31c000/buygety-recommend_17xnkw7.png)
**Order discount**
Shown as a progress bar instead of a badge.
| Setting | Description |
| ---- |
| Badge label | Supports `{{value_to_go}}` and `{{discount}}` variables. Default: `{{value_to_go}} away from {{discount}} off` |
| Text color | Default: `#565656` |
| Background progress color | Default: `#E8E8E8` |
| Main progress color | Default: `#1F41AF` |

![Cart recommendation progress bar for Order Discount campaign](https://storage.crisp.chat/users/helpdesk/website/-/8/3/8/3/8383e5404a31c000/orderdiscount-recommend_11vs73o.png)

**One discount**
Shows a preview section listing all included rewards (free gifts, discounted items, order discount, free shipping).
| Setting | Description |
| ---- |
| Section label | Heading above the reward list. Default: `Also includes` |
| Background color | Section background. Default: `#FFFFFF` |
| Gift label | Default: `Free gift`. Text color default: `#017B56` |
| Cross-sale label | Default: `{{discount}} Off`. Text color default: `#016AA8` |
| Order discount label | Default: `{{discount}} entire order`. Text color default: `#7109E7` |
| Free shipping label | Default: `Free shipping`. Text color default: `#BB4E01` |

Variables like `{{discount}}` and `{{value_to_go}}` are automatically replaced with live campaign values at runtime.

![Cart recommendation rewards preview for One Discount campaign](https://storage.crisp.chat/users/helpdesk/website/-/8/3/8/3/8383e5404a31c000/onediscount-recommend_wgxuwl.png)

## Limitations

* The widget only appears when the cart contains at least one product tied to a selected campaign.
* Maximum 10 active campaigns can feed the widget at once.
* Free plan stores can only run one campaign at a time, which limits how much the AI engine can recommend.

## Related articles
* Create an offer
* Cart Discount
* Popup Widget