> For the complete documentation index, see [llms.txt](https://support.heyamplify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.heyamplify.com/bundles-and-upsell/buy-x-get-y/how-to-create-a-buy-x-get-y-bogo-scenario.md).

# How to create a Buy X Get Y (BOGO) Scenario

## What is **Buy X Get Y (BOGO)** Scenario?

The **Buy X Get Y (BOGO)** scenario is a powerful promotional feature available inside the **Bundles & Upsell app** by Amplify. It allows merchants to create special offers where customers can purchase a specific product (Product X) and automatically receive another product (Product Y) as a free gift, added directly to the cart without extra steps.

***

## Steps to create a **Buy X Get Y (BOGO)** offer

#### Step 1: **Access the Scenarios Section**

Click on **Bundles & Upsell** and on **"Buy X Get Y",** click "**Create**".

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

#### **Step 2: Create a New Rule**

Select the option to "**Add rule**".

<figure><img src="/files/6RLCGaNVlc6A0LYNB6bm" alt=""><figcaption></figcaption></figure>

#### **Step 3.1: Select the product customers need to purchase (Product X)**

* On the left side of the drawer, click "**Select products**".
* Choose the product(s) that will be the condition for the free gift.

<figure><img src="/files/5e0krs901O6U6nFOAvD7" alt=""><figcaption></figcaption></figure>

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

#### Step 3.2: Select the free gift (Product Y)

* On the right side of the drawer, click **Select Product**.
* Choose the product that will be added as a free gift.

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

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

#### Step 4: **Save the scenario**

Once you’ve selected the trigger product and the free gift, click "**Save"** to save the rule.

<figure><img src="/files/73ZKIWOCCr26FZP2Dgk1" alt=""><figcaption></figcaption></figure>

***

## Buy X Get Y Customization

#### Step 4: Customize the Buy X Get Y widget

* In the scenario editor, click on the **Design** tab.
* Customize the widget as needed:
  * Change the "**Max gift limit warning"**.
  * Toggle the "**Plus icon"** on or off.
  * Edit the "**Title"**, choose to "**Display Comparet-at price**" and edit the "**Main & Highlight Colors**".

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

#### Step 6: Save changes

When done, click "**Save"** to apply your changes.

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

***

## How to publish the widget

#### Step 7: Activate the widget

When you're ready to display the widget on your live store, click the **three-dot menu** (•••) in the top right corner of the scenario editor and select "**Active**".

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

#### Step 8: Choose where to show the widget

A popup will appear. Select the **product page template** where the offer should appear. This should match the product(s) you set in the scenario. Then, click "**Add to Store**".

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

#### Step 9: Place the App Block in the theme editor

Shopify’s theme editor will open. The "**Buy X Get Y**" App block will be automatically added to the product template.\
You can drag and reposition it anywhere on the page layout to best match your store design.

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

#### Step 10: Save your theme changes

After placing or adjusting the App Block, click **Save** in the top right corner of the Shopify theme editor.

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

#### Step 11: Confirm the widget is published

Return to the "**Bundles & Upsell**" app. If the App Block was added successfully, you’ll see a confirmation message that the widget is active and detected.

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

:tada:***Congratulations, the Buy X Get Y is now live on your store*** :tada:

***

<details>

<summary>Can I create multiple Buy X Get Y offers for different products?</summary>

Yes, you can create as many scenarios as you like, each linking a different Product X and Product Y.

</details>

<details>

<summary><strong>Will the free Product Y be automatically added to the cart?</strong></summary>

Yes, when a customer adds Product X to their cart, Product Y will be automatically included.

</details>

<details>

<summary>Can customers see the offer on the product page?</summary>

Yes, the widget will display the offer on the product page, provided the App Block is properly added.

</details>

<details>

<summary>Can I customize the look and text of the widget?</summary>

Yes, you can edit texts from the **Design** tab in the scenario settings. For deeper styling, custom CSS can be used.

</details>

***

### Conclusion

The **Buy X Get Y** scenario in Bundles & Upsell is an easy-to-set-up, highly effective promotional tool that boosts AOV (Average Order Value) and enhances the shopping experience. By displaying the offer directly on the product page and handling the gift addition automatically, merchants can create seamless and enticing promotions that convert.

***

<table data-card-size="large" data-column-title-hidden data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><mark style="color:purple;"><strong>Get Bundles &#x26; Upsell</strong></mark> </td><td>Try free </td><td> </td><td><a href="https://apps.shopify.com/product-kits-bundles-pickystory?surface_intra_position=1&#x26;surface_type=partners&#x26;surface_version=redesign">https://apps.shopify.com/product-kits-bundles-pickystory?surface_intra_position=1&#x26;surface_type=partners&#x26;surface_version=redesign</a></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://support.heyamplify.com/bundles-and-upsell/buy-x-get-y/how-to-create-a-buy-x-get-y-bogo-scenario.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.