# Primary Upsell
#### What is Primary Upsell?
Primary Upsell displays a carousel of selected products on the Thank You and Order Status pages, encouraging customers to add items to their order during the editing window. This is one of your most powerful tools for increasing post-purchase revenue.
#### How the Primary Upsell Appears to Customers
Customers see a sliding carousel of products they can browse and add to their order with a single click. The carousel makes it easy to discover complementary items or products they may have forgotten.
***
### When to Use Primary Upsell
Best for: Stores wanting to increase average order value through strategic product recommendations.
**Examples:**
* Fashion retailer: Customer buys a dress, carousel shows matching accessories with 10% discount
* Supplement store: Customer orders protein powder, carousel displays shaker bottles and vitamin bundles
* Home goods: Customer purchases bedsheets, carousel features matching pillowcases and throw blankets
The Primary Upsell will be displayed to all your customers. For a more strategic approach to upselling, you can create customer-specific strategies in Upsell Strategies
Learn more about Upsell Strategies
***
### Configuring Primary Upsell
#### How to Enable Primary Upsell:
1. Navigate to App Blocks in your Order Editing dashboard
2. Locate Primary Upsell
3. Toggle ON
4. Click Save
***
### Selecting Upsell Products
You have two methods for choosing which products appear in the Primary Upsell carousel:
#### Method 1: Manual Selection
Choose specific products individually:
1. In the Primary Upsell settings, locate Upsell Products
2. Click Add Products
3. Search for and select individual products
4. Click Add or Save
Best for: Curated selections or highly strategic upsells
#### Method 2: Automatic Selection (Filters)
Use filters to automatically include products based on criteria:
1. In the Primary Upsell settings, locate Upsell Products
2. Click Add Filter or Use Filter
3. Select your filter type:
4. Tags - Include all products with specific tags (e.g., "upsell", "bestseller")
5. Collections - Include all products from selected collections (e.g., "Accessories")
6. Click Save
**Best for:** Large catalogs or products that change frequently
***
### Setting Upsell Discounts
#### How to Set Product Discounts:
1. In the Primary Upsell settings
2. After selecting products (manually or by filter)
3. Enter a discount percentage for the upsell products
4. Example: Enter "10" for 10% off upsell items
5. Click Save
#### Important: Discount Priority
If you've set a Global Discount in Settings, whichever discount is higher will be displayed to customers.
Example:
* Global Discount: 5%, Primary Upsell Discount: 10%
* Customer sees: 10% off (the higher discount)
***
### Limiting Products in Carousel
#### How to Limit Product Results:
1. Navigate to One Click Upsell Rules (within App Blocks or Settings)
2. Locate Limit Product Results
3. Enter the maximum number of products to display
4. Example: Enter "8" to show only 8 products in the carousel
5. Click Save
Recommendation: 6-12 products works well for most merchants.
***
### Allow Duplicate Items
#### What is Allow Duplicate Items?
This setting determines whether customers can add a product that's already in their cart again through the Primary Upsell.
#### How It Works:
When enabled:
* Original item stays at full price
* Additional item added via Primary Upsell receives the post-purchase discount
* Order shows two separate line items
Example: Original order has 1 Blue Shirt at $30. Customer adds another via Primary Upsell at $27 (10% discount). Final order: 2 Blue Shirts - one at $30, one at $27.
#### How to Enable/Disable:
1. In the Primary Upsell settings
2. Locate Allow Duplicate Items
3. Toggle ON to allow duplicates, OFF to prevent them
4. Click Save
5. Go to Upsell Strategies
6. Click Settings
7. Click Developer Settings
8. Toggle ON “Allow customers to upsell with a product already purchased in cart”
Enable if: You sell consumables or products commonly bought in multiples (supplements, basics, gifts)
**Disable if:** You sell one-per-customer items or have limited inventory
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://order-editing.gitbook.io/oe-help-book/self-service-edits/app-blocks/primary-upsell.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.