> For the complete documentation index, see [llms.txt](https://magecomp.gitbook.io/shopify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://magecomp.gitbook.io/shopify/apps/quo-volume-discount-tier-price/buy-x-get-y-discount.md).

# Buy X Get Y Discount

The Buy X Get Y Discount feature allows you to create promotions where customers receive a free or discounted item when they purchase a specific quantity or type of product.

To apply this feature, first **click on the “Create Buy X Get Y Discount” button**. Then, follow the steps to set up your discount campaign.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FnvciMxaM6xjfAu2Rqu2q%2FScreenshot%20(44).png?alt=media&amp;token=71896da4-ca6a-408a-950e-31005f1c5185" alt=""><figcaption></figcaption></figure>

#### Steps to Create a Buy X Get Y Discount

1. **Discount Title**\
   Enter a name for your discount campaign. This helps you identify it easily in your dashboard.
2. **Start Date & End Date**
   * **Start Date**: Select the date when the discount will begin (dd-mm-yyyy).
   * **End Date**: Select the date when the discount will end (dd-mm-yyyy).
3. **Limit Number**
   * Set the total number of times this discount can be used across all customers.
   * Optionally, **limit to one use per customer lifetime** to prevent repeated use by the same customer.
4. **Customer Buys**\
   Define the purchase conditions required to trigger the discount:

   * **Min Quantity**: Minimum number of items the customer needs to buy.
   * **Min Amount**: Minimum total purchase amount required.
   * **Select Buy Type**: Choose whether the condition applies to **Specific Products**.
   * **Select Buy Products**: Pick the products that must be purchased to qualify.

   <figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FFSIiZe0PJ8mtglUWVhqh%2Fimage.png?alt=media&amp;token=f3b2bc31-351e-4d43-8ceb-f992e264b12f" alt=""><figcaption></figcaption></figure>
5. **Customer Gets**\
   Define what the customer receives when the conditions are met:

* **Select Get Type**: Choose whether the reward applies to **Specific Products**.
* **Select Get Products**: Pick the products the customer will receive as part of the promotion.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fl9CRlLTN8QMqroyQiG2c%2Fimage.png?alt=media&amp;token=72fa2eb8-5d4e-4313-984c-7e078f474737" alt=""><figcaption></figcaption></figure>

You can also **preview the campaign details** beside the fields. Once all fields are configured, **save your campaign**. The discount will automatically activate according to the start and end dates you’ve set.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FMywmy4lAvrzZZ40K7PsC%2Fimage.png?alt=media&amp;token=9bc9e97f-b185-4257-ad0d-650cd98e0b79" alt=""><figcaption></figcaption></figure>

#### **Customize Settings – Buy X Get Y Discount**

Visit the customize section to control how the *Buy X Get Y Discount* card appears in your app. These settings allow you to adjust text, colors, spacing, and overall design to match your store theme.

**1. Title Name**

* Enter the heading you want to show above the discount card.
* Default example: **Buy X Get Y Discount**

**2. Title Text**

* This text appears as the main title above the offer card.
* You can customize it to match your campaign message.

**3. Title Color**

* Select the color for the title text.
* Example: `#000000`

**4. Title Bold**

* Set the font-weight of the title.
* Example: **600** for semi-bold.

**5. Image Padding**

* Controls the spacing around the discount image (if any).
* Example: **20**

**6. Card Text Size**

* Adjust the font size for the text inside the discount card.
* Example: **15**

**7. Card Text Color**

* Choose the color of the text inside the card.
* Example: `#000000`

**8. Background Color**

* Set the background color of the discount card.
* Example: `#ffffff`

**9. Border Style**

* Choose the border type for the card.
* Available options:
  * **Solid**
  * (Other border styles if available)

**10. Border Color**

* Select the color for the border of the card.
* Example: #00000

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FIJdrYyiOfbCtZx4BGfwU%2FScreenshot%20(57).png?alt=media&amp;token=f9c44221-df1b-4633-834f-219c2dc3f9f1" alt=""><figcaption></figcaption></figure>

Once you configure the settings, the preview will lets you visualize how the discount card will look before publishing it in your store.
