> 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](/discounts-and-gwp/using-gwp-and-discounts/create-a-product-discount.md)
2. [Create an order discount](/discounts-and-gwp/using-gwp-and-discounts/create-an-order-discount.md)
3. [Discount Code Generator](/discounts-and-gwp/using-gwp-and-discounts/discount-code-generator.md)
4. [When to use Roadmap, Shopify, or Klaviyo for discounts](/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](/discounts-and-gwp/using-gwp-and-discounts/gift-with-purchase.md)
2. [Create a Gift with Purchase discount](/discounts-and-gwp/using-gwp-and-discounts/create-a-gwp.md)
3. [Use tags for discount eligibility](/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](/discounts-and-gwp/using-gwp-and-discounts/discount-codes-with-gwps.md)
* [Run multiple discounts & GWPs at once](/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps.md)
* [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)

### Troubleshooting

Start with the symptom you see:

* [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)

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