> For the complete documentation index, see [llms.txt](https://docs.intelligems.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intelligems.io/merchandising-experiences/offer-modifications.md).

# Merchandising Experiences Overview

Merchandising modifications allow you to serve discounts and promotions to your visitors without code leakage, test them against each other, and track their success.

A Merchandising Experience changes the offer in the cart. Shoppers get the discount or the gift automatically when they qualify, with no code to enter.

Run it as a **Test** and Intelligems holds back a control group and reports what the offer did to AOV and profit per visitor. Run it as a **Personalization** and the offer stays on for the audience you target.

### **The 4 experience types**

Click **New Merchandising Experience** on the Merchandising page and these show up as cards.

| Type                                                                                                                         | What it's for                                        |
| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| [**Amount off Products**](/merchandising-experiences/offer-modifications/how-to-set-up-an-amount-off-products-experience.md) | Discount specific products by percentage or amount   |
| [**Amount off Order**](/merchandising-experiences/offer-modifications/how-to-set-up-an-amount-off-order-experience.md)       | Apply an automatic cart-wide discount                |
| [**Volume Discount**](/merchandising-experiences/offer-modifications/how-to-set-up-a-volume-discount-experience.md)          | Reward larger quantities with tiered pricing         |
| [**Free Gift**](/merchandising-experiences/offer-modifications/how-to-set-up-a-free-gift-experience.md)                      | Add a free gift when the cart hits a threshold       |
| [**Buy X Get Y**](/merchandising-experiences/offer-modifications/how-to-set-up-a-buy-x-get-y-bxgy-experience.md)             | Buy X, get Y free or discounted                      |
| [**Onsite Upsell**](/merchandising-experiences/offer-modifications/how-to-set-up-onsite-upsells.md)                          | Recommend add-ons on the product page or in the cart |

Volume Discount supports up to seven tiers, so you can go well past buy-two-save-ten and find where the extra unit stops paying for itself.

Onsite Upsell is in beta. You can request access from its setup guide.

## Setting up Merchandising Components

You can optionally show various [components](/merchandising-experiences/offers-integrating-widgets.md) that communicate your offer to users. The components vary depending on what type of merchandising offer modification you are using, but the full options include:

* **Pop Up / Slide Out:** This pop up location can be configured during setup. The language and colors are fully customizable so you can use this feature to highlight what you want.

{% hint style="warning" %}
**Pop Up / Slide Out Messages** are only shown on the homepage and cannot be configured to be shown on any other pages at this time.
{% endhint %}

* **Quantity Buttons:** These buttons will appear on your product pages for customers to quickly add multiple units to cart. They are automatically installed via the Intelligems script. If you have any trouble with these showing up inside an Offer Personalization, [please use this form to contact our support team](https://portal.usepylon.com/intelligems/forms/intelligems-support-request). Let us know which experience and specific URLs we can help you with.
* **Shipping Progress Bar & Offer Progress Bar:** This bar will appear in the cart view to show your customers how much more they need to purchase to achieve specific discounts or free shipping, prompting them to buy more to get the best deal without ever leaving their cart. More info [here](/merchandising-experiences/offers-integrating-widgets.md).

{% hint style="danger" %}
**Headless Stores:** Components do not work out-of-the-box and customers must build their own front-end implementation.
{% endhint %}

## How do offers Work?

Intelligems uses [Shopify Discount Functions ](https://shopify.dev/docs/api/functions/reference/product-discounts)to provide the offers you set up in the Intelligems app. The necessary Function will be created automatically when you create a new offer Experience or offer test in the Intelligems app, but will not be available to customers until you start your offer test or activate your the Experience containing your offer.

Offers have a cap and can be combined with each other and with Shopify discounts. See [Merchandising Experience Limits](/merchandising-experiences/offer-modifications/offers-limits.md) and [Merchandising Combinations](/merchandising-experiences/offer-modifications/offer-combinations.md).

Before you start one, walk the [Merchandising Experience QA Checklist](/merchandising-experiences/offer-test-qa-checklist.md). The [Merchandising Experiences FAQs](/merchandising-experiences/merchandising-experiences-faqs.md) cover discount stacking, minimums, and gift behavior.


---

# 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://docs.intelligems.io/merchandising-experiences/offer-modifications.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.
