> 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/getting-started.md).

# Getting started

Learn how Gift with Purchase, product discounts, and order discounts work, then choose the right setup path.

Use this section to set up and troubleshoot **Discounts & GWP**.

Start with the path that matches your goal.

### New to Roadmap discounts

Read these first:

1. [Create a product discount](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/create-a-product-discount.md)
2. [Create an order discount](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/create-an-order-discount.md)
3. [Discount Code Generator](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/discount-code-generator.md)
4. [When to use Roadmap, Shopify, or Klaviyo for discounts](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/when-to-use-roadmap-shopify-or-klaviyo-for-discounts.md)

### New to Gift with Purchase

Read these first:

1. [Gift with Purchase](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/gift-with-purchase.md)
2. [Create a Gift with Purchase discount](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/create-a-gwp.md)
3. [Use tags for discount eligibility](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/use-tags-for-discount-eligibility.md)

### Running more than one offer

Use these guides when promotions may overlap:

* [Discount codes with GWPs](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/discount-codes-with-gwps.md)
* [Run multiple discounts & GWPs at once](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps.md)
* [Combine GWPs with loyalty rewards or bundles](https://docs.roadmap.so/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps/combine-gwps-with-loyalty-rewards-or-bundles.md)

### Troubleshooting

Start with the symptom you see:

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

### Quick answers

#### What does a GWP look like when it works?

Usually, the gift appears as a new line item in cart.

#### What breaks a GWP most often?

Usually one of these:

* the offer is inactive
* the cart does not meet the conditions
* the shopper is not eligible
* another promotion overlaps

#### Should I build this in Roadmap or Shopify?

Use Roadmap when the rule depends on cart logic, product combinations, tags, membership, or automatic audience-aware behaviour.

Use Shopify when the discount should be native, code-driven, or managed outside Roadmap.

#### What should I test before launch?

Test one cart that should fail and one cart that should pass.

If eligibility uses tags or member tiers, test with a real logged-in customer.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.roadmap.so/discounts-and-gwp/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
