> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/gift-with-purchase.md).

# Gift with Purchase

Understand how GWPs work, how to set them up, and where to troubleshoot common issues.

Use Gift with Purchase when you want a free item added automatically after a shopper qualifies.

The success signal is the **gift line item in cart**. It is not always a visible price discount.

### Important behavior to understand

A standard Roadmap GWP adds the gift automatically.

The customer does not choose the gift inside the GWP flow.

If you select multiple variants in **Free Gifts**, all selected variants are gifted when the offer qualifies.

Roadmap does not treat that list as `pick one of these gifts`.

{% hint style="info" %}
If the shopper should choose one gift from several options, do not use a standard GWP for that.

Use a choice-based setup instead.

See [Offer a choice of free gift](/discounts-and-gwp/using-gwp-and-discounts/offer-a-choice-of-free-gift.md).
{% endhint %}

### How a GWP works

Every GWP has four parts:

* **Conditions** decide what must happen first.
* **Customer Eligibility** decides who can qualify.
* **Free Gifts** decides what gets added.
* **Active Dates** decides when it runs.

### Common condition types

Use **Minimum Spend** when the gift should unlock after a subtotal threshold.

Use **Buy X Get Y** when the gift depends on a product, variant, or quantity.

Use **Buy A+B+C Get Y** when shoppers must add a specific mix of items.

### Common eligibility options

Use **All customers** for broad campaigns.

Use **Logged in only customers**, **Customers tagged with**, or **Members** when the gift should be limited to a segment.

### Free gift settings that matter most

Choose the gift with **Search variants** or **Browse**.

If you choose more than one variant in **Free Gifts**, the offer adds all of them.

It does not present those variants as customer choice.

Set **Maximum number of uses per order** to control repeat gifting in one cart.

Use **Note** if you want customer-facing gift messaging in cart.

{% hint style="info" %}
If **Maximum number of uses per order** is left as **No limit**, one order can receive multiple gifts when it qualifies multiple times.
{% endhint %}

### Create a GWP

{% stepper %}
{% step %}

#### Open Discounts / Gift with Purchase

Start from the main discounts dashboard.
{% endstep %}

{% step %}

#### Create a new discount

Choose **Gift with Purchase** as the method.
{% endstep %}

{% step %}

#### Set the rules

Add the **Name**, **Conditions**, **Customer Eligibility**, and **Free Gifts**.
{% endstep %}

{% step %}

#### Set dates and save

Choose **Status**, add **Active Dates**, then save.
{% endstep %}

{% step %}

#### Test with a fresh cart

Build a cart that clearly qualifies and confirm the gift line item appears.
{% endstep %}
{% endstepper %}

### Start with the guide that matches your goal

* [Create a Gift with Purchase discount](/discounts-and-gwp/using-gwp-and-discounts/create-a-gwp.md)
* [Offer a choice of free gift](/discounts-and-gwp/using-gwp-and-discounts/offer-a-choice-of-free-gift.md)
* [Run multiple discounts and GWPs at once](/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps.md)
* [Use tags for discount eligibility](/discounts-and-gwp/using-gwp-and-discounts/use-tags-for-discount-eligibility.md)
* [Use discount codes with GWPs](/discounts-and-gwp/using-gwp-and-discounts/discount-codes-with-gwps.md)

### Troubleshoot fast

Start here if the gift is not behaving as expected:

* [GWP not showing at checkout](/discounts-and-gwp/troubleshooting/gwp-not-showing-at-checkout.md)
* [Discounts not applying correctly](/discounts-and-gwp/troubleshooting/discounts-not-applying-correctly.md)
* [Promotion not respecting quantity or spend limits](/discounts-and-gwp/troubleshooting/promotion-not-respecting-quantity-or-spend-limits.md)
* [GWP not working in Shopify POS](/discounts-and-gwp/troubleshooting/gwp-not-working-in-shopify-pos.md)

### Related guides

* [Combine GWPs with loyalty rewards or bundles](/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps/combine-gwps-with-loyalty-rewards-or-bundles.md)
* [Offer a choice of free gift](/discounts-and-gwp/using-gwp-and-discounts/offer-a-choice-of-free-gift.md)


---

# 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.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/gift-with-purchase.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.