> For the complete documentation index, see [llms.txt](https://docs.paretodeals.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paretodeals.com/offers/create-an-offer/buy-x-get-y.md).

# Buy X Get Y

**Example user case:** Offer 50% off one product from the "Accessories" collection when customers buy 3 or more items from the "Clothing" collection.

<figure><img src="/files/mSoC0a78vWQRzpDyt8Kp" alt=""><figcaption></figcaption></figure>

### I. Rule Settings

#### 1.  Choose X (What Customers Must Buy)

Start by selecting the type of items customers need to purchase (X) to qualify for the offer. You have three options:

* **Any items from online store:** Customers can purchase any items available in your store that meet the conditions for the discount.
* **Any items from specific collections:** Customers can purchase any item from selected collections that meet the conditions for the discount.
* **Any items from specific products:** Customers can purchase any item from selected products that meet the conditions for the discount.

<figure><img src="/files/W3tDQIbiEj68tSfGoByR" alt=""><figcaption></figcaption></figure>

#### 2. Set Up Rules

<figure><img src="/files/TEXtl2uxDXYpuRTRmzMG" alt=""><figcaption></figcaption></figure>

**Configure Purchase Conditions (X)**

* Quantity/Amount Range
  * Enter the **"Buy from"** and **"Buy to"** values to define the quantity or purchase amount needed to qualify.
  * Enter 0 in the "Buy to" field if you don’t want to set a maximum limit.

**Define the Discounted Products (Y):** Choose what products (Y) will be discounted or free when the rule is met. You have four options:

* Discount for the Least Expensive Product in X: Automatically apply the discount to the least expensive product from the selected X items.
* Discount for Any Items from the Online Store: Apply the discount to any product available in your store.
* Discount for Any Items from Specific Collections: Apply the discount to any product from selected collections.
* Discount for Any Items from Specific Products: Apply the discount to specific products of your choice.

**Set Discount Details**

* Discounted Quantity: Enter the quantity of discounted products (Y) that customers will receive.
* Discount Value: Choose the type of discount to apply
  * Percent: Discount by a percentage (e.g., 50% off).
  * Fixed Amount: Deduct a specific amount (e.g., $10 off).
  * Free: Offer the discounted products for free.

**Add Multiple Rules**

* Use the **Add** button to create new quantity ranges.
* Click the **Remove** icon to delete a range if needed.

#### 3. Apply to market

Set personalized discount rules for each market or country, tailoring discount values to suit regional needs.

<figure><img src="/files/DXilVHSZIlgWnrvvcE7W" alt=""><figcaption></figcaption></figure>

#### 4. Target customer

Select the specific customer group(s) to apply this discount rule. There are 4 options:

* **All visitors:** Apply this discount to all visitors who browse your website.
* **Logged-in customers:** Apply this discount to customers who are logged into their accounts on your store.
* **Logged-in with tag:** Apply this discount to logged-in customers who have the specified tags assigned to their accounts.
* **Customers without tag:** Apply this discount to all visitors or customers who do not have the specified tags.

<figure><img src="/files/EnLe2btvQalHgYWZ0KVn" alt=""><figcaption></figcaption></figure>

#### 5. Schedule

Set a schedule for this offer to activate and run automatically at the defined time.

<figure><img src="/files/37KN1cq1Vso1iWtWiURj" alt=""><figcaption></figcaption></figure>

### II. Display settings

Customize how discount rules are displayed on your store.

#### 1. Product page

Allows you to set up a discount widget that displays on the product page

* Countdown timer settings

<figure><img src="/files/cOQyoENxqKyeKEXT6DRD" alt=""><figcaption></figcaption></figure>

* Show/hide campaign name

<figure><img src="/files/eWRG9MoJT9DT4qkttkZ4" alt=""><figcaption></figcaption></figure>

* Layout settings

<figure><img src="/files/GszTmfz2r9Osh2MqeBMH" alt=""><figcaption></figcaption></figure>

* Font settings

<figure><img src="/files/qzrwbpp5orAjPQGy9Egz" alt=""><figcaption></figcaption></figure>

* Color settings

<figure><img src="/files/ukVVlSHQoX5sbXqwqUHZ" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="/files/9dor4yrXGqPVm9fXdmXd" alt=""><figcaption></figcaption></figure>

#### 2. Pop-up suggestions

Allow you to recommend additional products to customers so they can qualify for discounts.

* Popup display options:
  * **Auto Add Discounted Products to Cart:** Automatically adds the discounted products to the customer's cart without showing the pop-up.
  * **Display a Suggestion Pop-up to Select the Discounted Items:** Displays a pop-up for customers to select recommended products to qualify for the discount.
  * **Not Displayed:** Disables the pop-up suggestion.
* Layout settings

<figure><img src="/files/Rtu7HvaR0WEmNtoN4MNj" alt=""><figcaption></figcaption></figure>

* Product card settings, color settings

<figure><img src="/files/p7uAV72s38LiiwCIuQqP" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="/files/2D5VSffK0UD68GI9qzGM" alt=""><figcaption></figcaption></figure>

#### 3. Notice in cart

Allows you to display contextual messages in the cart to guide customers about discounts and gift options

* **Buy more notification:** Encourages customers to add more items to their cart to qualify for the discount.
* **Get gift notification:** Notifies customers that they qualify for a discount but need to choose their discounted items.
* **Change gift notification:** Allows customers to update or change their selected discounted products.

<figure><img src="/files/X9ilvlWffqt2pTcEm7tE" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="/files/cxdy9UfgvAhEU4TBo0Sz" alt=""><figcaption></figcaption></figure>

### III. Checkout upsell

Display campaign on the checkout page to increase sales.

#### 1. Active upsell display

<figure><img src="/files/m41QyiMy9NtxE2YkktzR" alt=""><figcaption></figcaption></figure>

#### 2. Add block to theme

<figure><img src="/files/BsXSPPUdLR8ZiTj8R12i" alt=""><figcaption></figcaption></figure>

**3. Customize layout settings**

<figure><img src="/files/8OaL30QQwOsPaHdAk4z5" alt=""><figcaption></figcaption></figure>