---
title: "Create HQ discounts with cross-venue redemption limits"
slug: "create-hq-discounts-with-cross-venue-redemption-limits"
updated: 2026-06-16T12:55:02Z
published: 2026-06-16T19:31:02Z
canonical: "mysupport.roller.software/create-hq-discounts-with-cross-venue-redemption-limits"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt
> Use this file to discover all available pages before exploring further.

# Create HQ discounts with cross-venue redemption limits

Create discount codes once in HQ and assign them to specific venues — so guests can redeem the same code across your group, with redemptions counted across all selected venues. Run group-wide promotions knowing the total number of redemptions stays within your planned limit, no matter which venue a guest visits.

> [!CAUTION]
> HQ subscription
> 
> Available for all HQ venues. To learn more, contact your customer success manager or the [support team](/v1/docs/contact-roller-support).
> 
> [Learn more](https://www.roller.software/products/hq-add-on/)

## How HQ discount codes work

HQ discount codes let you create a discount once and make it available across multiple venues in your group. Instead of building the same code at each venue, you create and manage it centrally from HQ, and it syncs automatically to the venues you select.

When you assign a discount to venues, it appears on the **Discount** **codes** page at each selected venue with an **HQ** label. Venues staff cannot edit **HQ discounts** unless HQ [staff permissions](/v1/docs/create-and-manage-staff-roles-and-permissions) allow it — any changes you make in HQ apply to all selected venues automatically.

You can control how usage limits apply across your group. By default, limits apply per managed venue.

If you select **Usage limits apply across selected venues**, the total use limits configured are shared across all selected venues — for example, a code with a 500-use limit can be redeemed 500 times in total across the group, not 500 times at each venue.

When you remove a venue from a saved discount, the discount is archived at that venue.

![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16244864879247.png)

## Create a new HQ discount

1. From HQ, go to **Products** > **Discount codes** > **Create discount code**.
2. Under **Venues**, select the venues or [venue tags](/v1/docs/create-and-manage-venue-tags-groups-in-hq) that can access this discount. Any changes will apply to all selected venues automatically. For example, apply a summer promotion to all venues tagged "Beach locations" rather than selecting each venue individually. ![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229457579151.png)
3. To count usage across all selected venues, select **Usage limits apply across selected venues**.

When selected, a code's [discount use limits](/v1/docs/create-hq-discounts-with-cross-venue-redemption-limits#h_01KSDNMS5JVXH7GHZVAC462RSZ) apply once across the group — for example, a two-use discount can be redeemed twice in total across selected venues, not twice at each venue. ![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229411534607.png)
4. Under **Content**, enter a **Discount name**. This is used internally and must be unique.
5. If you're creating a discount for staff, select **This is a staff only discount**.

## Configure the discount details

Under **Discount details**, complete the following:

1. **Discount type** — select Percentage, Fixed amount, Buy & Get or Flat price. [Learn more about the different types of discount codes](/v1/docs/get-started-with-discount-codes).
2. **Value** — enter the discount value.
3. **Products** — select which products the discount applies to: **Specific products, All products (excl. gift cards) or Gift cards.**

![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229506792975.png)

## Choose how to generate the discount code(s)

1. Under **Discount codes**, select how you want to create the codes: **Create custom codes**, **Upload codes** or **Issue code on purchase**.
2. For **custom** **codes**, you can enter your own code, or select **Generate** **code** to automatically generate a code or codes. ![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229603063695.png)
3. If you select **Issue code on purchase**:
  - Select the products that will trigger the code to be issued.
  - To use the guest's ticket ID as their discount code, select **Use ticket ID as discount code**. When selected, the discount must be redeemed on the same day as purchase.
  - To print the code on the guest's receipt, select **Print discount on receipt**.
  - Under **Sales channels**, select which channels should issue the code at the time of purchase: **Checkout & API**, **Self Serve Kiosk**, **Point of Sale** or **Venue Manager**.

## Share a discount link with guests

If you select **Create custom codes** or **Upload codes**, you can create a shareable link to apply the discount automatically at checkout.

1. Select **Shareable discount URL**, then add instructions in the **Add redemption instructions** field.
2. The shareable URL can be added to emails, SMS or campaigns to send guests directly to a venue's checkout with the discount applied.
3. You'll need a checkout URL for each venue.
4. Select **Edit** to open the URL settings, where you can choose each venue's destination checkout and the discount code to use. Copy the generated URL, then select **Save.**
5. Shareable discount URLS work with full-page progressive checkouts only. They're not available for overlay or legacy checkouts.

To learn more, see the guide [Share a discount with a checkout link](/v1/docs/share-a-discount-with-a-checkout-link).

## Set discount availability

Select any availability restrictions you want to apply:

- **Discount usage** — choose when guests can apply the discount across your venues.

Select **Ongoing** for no end date, or **Date range** to restrict to specific dates and times — for example, use before 31 Jan to receive 20% off.
- **Visit dates** — choose when guests must visit to redeem the discount.

Select **Ongoing** for no end date, or **Date range** to restrict to specific dates and times — for example, visit on Mondays before 10 AM to receive 20% off.

Example: To run a weekday promotion across two periods at all selected venues, set **Discount usage** to **Ongoing** from 1 Feb, then add two Visit date ranges:

1 Mar–31 Mar, Mon–Thu, 11 AM–3 PM 1 Sep–30 Sep, Mon–Thu, 11 AM–3 PM

Guests can use the same discount code across all selected venues. To qualify, they need to visit Monday–Thursday between 11 AM and 3 PM in March or September.

![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229588009103.png)

## Additional options

Under **Additional options**, configure discount uses limits and if needed, the maximum discount per booking.

### Limit discount uses

**Limit discount uses**

Discount use limits must be configured if you want the discount to apply to more than one eligible product in a single checkout. Without a discount use limit, the discount applies to only one product in the cart by default.

To limit how many times the discount can be used, select **Limit discount uses**, then set the number of uses and select a limit type:

**Per code**

Sets how many times the code can be used across your entire guest base. For fixed-amount discounts on selected products, the discount applies to one applicable item per cart and counts as one use.

When [Usage limits apply across selected venues](/v1/docs/create-hq-discounts-with-cross-venue-redemption-limits#h_01KSCR2WHMPHRH85B2NFSG5WST) is selected in the HQ discount setup, this limit applies once across all selected venues.

- Select **Include booking rule** to set the maximum number of booking items the discount can apply to within a single booking. Each qualifying item counts as one use toward this limit.
- Select **Allow multiple uses in same booking** to let guests use the same code more than once within a single booking.

![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/16229529387151.png)

**Per code per day**

Works like Per code, but resets the limit each day within any visit date restrictions you've set.

**Per guest**

Restricts each guest to using the code only once, to prevent multiple uses by the same guest.

Select **Include booking rule** to set the maximum number of times a guest can use the code for selected products in a single booking.

When **Usage limits apply across selected venues** is selected, Per guest is not available as a limit type.

**For each selected product (regardless of quantity purchased)**

Every booking transaction counts as one use of the code when applied, regardless of how many items are bought. For example, a code with a 10-use limit on General Admission — buying 5 tickets at once counts as 1 of the 10 uses.

Select **Codes can only be used once** to restrict the code to a single use per guest across all time.

**Across selected products (quantity purchased counts towards uses)**

Each qualifying item in a booking counts as one use. For example, a code with a 5-use limit for a session pass — buying 3 tickets in one transaction uses 3 of the 5 allowed uses.

Select **Codes can only be used once** to restrict the code to a single use per guest across all time.

### Maximum discount per booking

To cap the discount amount per booking, select **Set a maximum discount per booking** and enter the maximum amount.

For example, set a maximum of $20 so a 20% discount on a $150 booking caps at $20, not $30.

To limit how many times the discount can be used, select **Limit discount uses**, then set the number of uses and select a limit type:

## Save and automatically sync the discount to selected venues

Select **Save**. The discount syncs to the selected venues and appears on the **Discount codes** page in selected venues with an HQ label.

> [!NOTE]
> If the HQ discount code is not syncing, check that it doesn't already exist at the venue.

## Edit HQ discounts

Any changes made to saved HQ discounts will affect all venues who have been provided access to the discount.

If you remove venues from saved HQ discounts, the discounts will be archived at those venues.

HQ discounts are locked at managed venues and labelled with HQ.

1. From HQ, go to **Products** > **Discount codes**.
2. Select the name of the discount you want to edit.
3. Edit any of the discount code settings.
4. If you want to add or remove a linked venue from a discount, select the **Venues** field to open a drop-down, then add or remove a venue.
5. If you remove a venue, the discount will be archived at that venue.
6. Select **Save**. The updates are automatically added to the specific venues.

## Archive HQ discounts

1. From HQ, go to **Products** > **Discount codes**.
2. For the discount you want to archive, select the **options menu** (3 dots), then select **Archive**.
3. Check the number of linked venues that will be affected.
4. Select **Continue** to confirm. The discount will be archived at the linked venues.

## Learn more

- [Create and manage venue tags (groups) in HQ](/v1/docs/create-and-manage-venue-tags-groups-in-hq) — Group venues by region, franchise or brand to control which venues receive each HQ discount.
- [Discounts in ROLLER](/v1/docs/get-started-with-discount-codes) — Understand all discount types available in ROLLER, including Buy & Get and flat price, before creating your first code.
- [Permissions by feature and role](/v1/docs/permissions-by-feature-and-role) — See which permissions control discount code access by staff role, including Can access discount code settings and Can view discounts.
- [Share a discount with a checkout link](/v1/docs/share-a-discount-with-a-checkout-link) — Generate an address that applies the discount automatically at checkout — no code entry needed from guests.
- [HQ venue permissions by feature](/v1/docs/hq-venue-permissions-by-feature) — See a full list of features you can lock or allow at managed venues.
- [Track discount code usage](/v1/docs/track-discount-code-usage) — View how many times a discount has been used and which bookings applied it.
- [Discount code usage report](/v1/docs/discount-code-usage-report) — Compare your top codes by usage, total discount value and revenue impact across your venues in this Analytics report.

## Related

- [Create and manage HQ checkouts](/create-and-manage-hq-checkouts.md)
- [Create and manage HQ POS templates](/create-and-manage-hq-pos-templates.md)
- [Manage chargebacks with ROLLER Payments](/manage-chargebacks-with-roller-payments.md)
- [Can I apply a discount to one item only at POS?](/can-i-apply-a-discount-to-one-item-only-at-pos.md)
- [Get started with discount codes](/get-started-with-discount-codes.md)