> 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/create-a-gwp.md).

# Create a GWP

Set up a Gift with Purchase that adds the correct gift to the right customer at the right time.

Use this setup when a shopper should receive a free item automatically after qualifying.

### Important behavior to understand

This setup auto-adds the gift to cart.

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

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

Roadmap does not interpret that list as `choose one`.

{% hint style="info" %}
If the customer should choose one gift from several options, 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 %}

### Before you start

Decide these four things first:

* what should trigger the gift
* who should be allowed to qualify
* which gift variant or variants should be given
* whether one order can receive the gift more than once

### Create the GWP

{% stepper %}
{% step %}

#### Open Discounts / Gift with Purchase

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

{% step %}

#### Create a new discount

Choose **Gift with Purchase**.
{% endstep %}

{% step %}

#### Add a clear internal name

Use a name your team can recognise later.
{% endstep %}

{% step %}

#### Choose the condition

Pick the rule that should trigger the gift:

* **Minimum Spend**
* **Buy X Get Y**
* **Buy A+B+C Get Y**
  {% endstep %}

{% step %}

#### Choose who can qualify

Set **Customer Eligibility** only as wide as needed.
{% endstep %}

{% step %}

#### Add the gift variant or variants

Select the correct gift in **Free Gifts**.

If you select more than one variant here, the GWP adds all selected variants after the cart qualifies.

It does not let the customer pick one from that list.

Set **Maximum number of uses per order** if one order should receive the gift only once.
{% endstep %}

{% step %}

#### Set Active Dates and save

Choose the start time and optional end date, then save the offer.
{% endstep %}

{% step %}

#### Test with a fresh cart

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

### How to pick the right condition

Use **Minimum Spend** for threshold campaigns like "spend $100, get a gift".

Use **Buy X Get Y** for product-specific or quantity-specific offers.

Use **Buy A+B+C Get Y** when shoppers must add a set combination of products.

### How to avoid common setup mistakes

Check these before you go live:

* the gift variant is the correct one
* multiple selected gift variants are intentional
* the offer is set to **Active**
* the active dates are current
* the audience is not broader than intended
* the gift cap is not left on **No limit** unless that is intentional

### Test before launch

Run these tests:

1. a cart that does not qualify
2. a cart that clearly qualifies
3. a logged-in customer test if eligibility uses tags or member tiers

### Next steps

* [Offer a choice of free gift](/discounts-and-gwp/using-gwp-and-discounts/offer-a-choice-of-free-gift.md)
* [Use tags for discount eligibility](/discounts-and-gwp/using-gwp-and-discounts/use-tags-for-discount-eligibility.md)
* [Run multiple discounts and GWPs at once](/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps.md)
* [GWP not showing at checkout](/discounts-and-gwp/troubleshooting/gwp-not-showing-at-checkout.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/create-a-gwp.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.