> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.qikify.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).

# Product recommendations (Upselling)

# Overview
**Product Recommendations (Upselling)** is a free feature that displays a curated list of recommended products on the product page, encouraging customers to add more items to their cart. The widget appears with a custom title, subtitle, and optional badge — and can be tied to a discount to incentivize the upsell.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_12nifhd.png =400x448)
## How It Works

1. The merchant configures which products trigger the offer and which products to recommend.
2. On the storefront, the widget displays below (or alongside) the main product with a list of recommended items, each showing image, name, price, variant selector, quantity control, and an **Add** button.
3. Customers can add recommended products directly from the widget without navigating away.
4. An optional discount is applied automatically when the customer adds a recommended product.
---
## Offer Configuration
### 1 - Customer Buys (Trigger)
Defines which products cause the upsell widget to appear:
| Option | Description |
| ---- |
| **All products** | Widget appears on every product page in the store |
| **Collections** | Widget appears only on products belonging to selected collections |
| **Product Tags** | Widget appears only on products with specified tags |
| **Specific products** | Widget appears only on individually selected products |
| **Exclude products** | (Optional checkbox) Blacklist specific products from triggering when using All products or Collections trigger |

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_1ag9uog.png =400x220)
### 2 - Recommended Products
Defines which products are shown in the upsell widget:
| Option | Description |
| ---- |
| **Manual specific products** | Merchant hand-picks the products to recommend. Click **Browse** to select. Shows current count (e.g. "0 product selected") |
| **Automated recommendations** | Products are suggested automatically based on Shopify's recommendation algorithm |

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_6si8rr.png =400x246)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_1s6kveg.png =400x158)

**When using Automated recommendations:**
* Choose the recommendation type from the dropdown: **Related products** or **Complementary products**
* Recommendations are powered by [Shopify Search & Discovery](https://apps.shopify.com/search-and-discovery) — must be configured there for best results

### 3 - Display Settings
Controls the text and visual appearance of the upsell widget on the storefront:
| Field | Description |
| ---- |
| **Title** | Main heading of the widget (e.g. `Highly recommended!`, `WE THINK YOU'LL LOVE THESE`) |
| **Sub-title** | Supporting text shown below the title (e.g. `Get the most out of your items with these must-haves`, `Add more to get the best deal!`) |
| **Badge label** | Short label displayed as a badge next to the title (e.g. `Recommended`, `20% OFF`, `New`). Leave blank to hide the badge |
| **Background color** | Background color of the badge (hex value, e.g. `#e00000` for red) |
| **Text color** | Text color of the badge (hex value, e.g. `#ffffff` for white) |

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_nd52at.png =800x303)
### 4 - Discount Settings
An optional discount can be attached to the upsell offer to incentivize customers:
**Apply discount** — Check to enable. A discount code will be generated automatically.

1. Discount value
| Option | Description |
| ---- |
| **Percentage** | Discount as a percentage off (e.g. `10%`) |
| **Fixed amount** | Discount as a flat dollar amount off |

2. Combinations
Controls whether this discount can stack with other active discounts on the same order:
| Option | Description |
| ---- |
| **Product discounts** | Allow combining with other product-level discounts |
| **Order discounts** | Allow combining with order-level discounts |
| **Shipping discounts** | Allow combining with shipping discounts |

3. Max discount uses
| Option | Description |
| ---- |
| **Limit number of times this discount can be used in total** | When checked, set a cap on total redemptions across all customers |

4. Customer eligibility
| Option | Description |
| ---- |
| **All customers** | Discount applies to every customer |
| **Specific customer segments** | Restrict to customers in defined segments |
| **Specific customers** | Restrict to individually selected customer accounts |

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_17yel8l.png =400x579)
### 5 - Advanced Settings
| Option | Description |
| ---- |
| **Allow editing quantity of items** | When enabled, customers can adjust the quantity of a recommended product before adding it to cart |
| **Show offer based on rules** | When enabled, the widget only appears if specific conditions are met (e.g. cart value, customer tag). Configure the rules after enabling |

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_ug3j9k.png =400x372)

### 6 - Schedule
Control when the offer is active:
| Field | Description |
| ---- |
| **Start date** | The date the offer goes live (format: `YYYY-MM-DD`) |
| **Start time** | The time the offer goes live, shown in the store's configured timezone offset (e.g. `-04:00`) |
| **Set end date** | Optional. When checked, allows setting a specific date and time for the offer to automatically deactivate |

**Countdown timer**
Enable a live countdown to create urgency. The timer counts down to the campaign end date/time

ℹ️ The countdown timer only works when an end date is set.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/3/f/6/33f605886cba4e00/image_1bunu1i.png =400x217)

| Hopefully this instruction has helped you. Things change all the time, so if you run into issues please don't hesitate to share them with us at [__contact@qikifysupport.on.crisp.email__](mailto:contact@qikifysupport.on.crisp.email) or use the in-app live chat. We're happy to lend a hand 🤗