> 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

Follow these steps to configure Buy X Get Y offers for your store

**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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2Fk4ZLyicxt5NzHLHJ5RAp%2Fimage.png?alt=media&amp;token=7d2411d9-2691-4ea7-96f8-2e56796fb7c9" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FJYh4Il5B3kguljMghCzR%2Fimage.png?alt=media&amp;token=eae589a1-934f-4744-ade3-22007693e8dc" alt=""><figcaption></figcaption></figure>

#### 2. Set Up Rules

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2F1yM09d320U9FHk65iCu7%2Fimage.png?alt=media&amp;token=8639eafd-98b8-4894-b225-06e68b20c86a" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FUIdqzqf1PV0FKRVApS8I%2Fimage.png?alt=media&amp;token=2011a3dc-2988-4b6b-8e80-c46a5dcb6d47" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FKRlAbQRBd1gdYXruMLlN%2Fimage.png?alt=media&amp;token=e4661347-75df-4cfb-b4df-b72fb15c9bfb" alt=""><figcaption></figcaption></figure>

#### 5. Schedule

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

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2F85p4FEe38HvC2uPSOfKA%2Fimage.png?alt=media&amp;token=e5b99e36-fede-4f37-a795-ae4d6dc63c4f" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2Fql0hrK0G2rlZWKpzwVYt%2Fimage.png?alt=media&amp;token=ecf027cf-6a7e-4b2d-8176-5d8f5d9dc44c" alt=""><figcaption></figcaption></figure>

* Show/hide campaign name

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FUjGX3EOPBzC1bai0luM3%2Fimage.png?alt=media&amp;token=a7b414be-a98e-422e-9b0b-032ada33b32a" alt=""><figcaption></figcaption></figure>

* Layout settings

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FeAvOmdJTTDAPQyMzAoXH%2Fimage.png?alt=media&amp;token=da6ffbb8-c173-482a-9c41-30a1ea5b003e" alt=""><figcaption></figcaption></figure>

* Font settings

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FonN0XMdkjzjpmKOmBPwA%2Fimage.png?alt=media&amp;token=a911b40b-79e0-46fe-b4f4-a05270d351d1" alt=""><figcaption></figcaption></figure>

* Color settings

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FRbm64wfaRGYb9tNnZhqX%2Fimage.png?alt=media&amp;token=4630b967-8aa3-4faf-932a-cebfb8d7b780" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2Fb6OqBbOJIlMPjNunlxxx%2Fimage.png?alt=media&amp;token=fc629d68-de04-4e9a-9e29-6f48ba1aa5af" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FDCw6GT7oBTvxXxKMWrHu%2Fimage.png?alt=media&amp;token=3de6b872-c94a-4969-98b7-a60ca008c99e" alt=""><figcaption></figcaption></figure>

* Product card settings, color settings

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FGjZ22pVTinQ6UF8UXiFy%2Fimage.png?alt=media&amp;token=1b0b8121-aa69-4e0a-abc3-57f9f6a88481" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FFpa5r2IrvevAEAe2SaJ2%2Fimage.png?alt=media&amp;token=04bb8162-0bcb-4c19-8eb9-ae51687c1bf0" 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="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FmRHdl9pBofkz8u6ddAun%2Fimage.png?alt=media&amp;token=c3424a5b-3a60-468c-9a49-2e9b8fabe995" alt=""><figcaption></figcaption></figure>

* Display on online store:

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FVUc9D9buqOGSfEVWw4jr%2Fimage.png?alt=media&amp;token=9aedbfc5-6d96-4c94-88a8-dfa738f9a4f7" alt=""><figcaption></figcaption></figure>

### III. Checkout upsell

Display campaign on the checkout page to increase sales.

#### 1. Active upsell display

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FjR6wE5KXxIpZYdfB6zXN%2Fimage.png?alt=media&amp;token=60729195-21ea-48c2-8e36-68056207f43d" alt=""><figcaption></figcaption></figure>

#### 2. Add block to theme

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2F4pYKyII5jFpr5WdlOeur%2Fimage.png?alt=media&amp;token=67594ced-513b-4856-b0d0-0e5f9309e2a9" alt=""><figcaption></figcaption></figure>

**3. Customize layout settings**

<figure><img src="https://62681540-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8LQe4uuTLE7aGCI7xhBW%2Fuploads%2FSMgjY9JYz0b2VxjOcMRa%2Fimage.png?alt=media&amp;token=b283b6c3-eb8c-47a9-acc8-5b1a482fe611" alt=""><figcaption></figcaption></figure>
