Promo code groups are reusable templates that organize your codes and optionally pre-fill new codes with default settings. Use them when you're running a campaign with many codes that share the same discount, dates, or scope, or just to keep your codes tidy.
Getting started
Navigate to Purchases > Promo codes and pick the Promo code groups tab. Click Create new promo code group at the top right to make a new one, or click any row to edit.
How it works
A group has a name, an optional description, and an optional default settings block. The default settings cover the same fields you'd configure on an individual promo code (redemption type, value, dates, scope, day rules, exclusions). When you assign a code to a group with defaults, you can flip a single toggle to copy those defaults onto the code, then customize as needed.
Groups don't have to carry default settings. A group with just a name and description is fine for organization-only use.
Step-by-step guide
Create a group
Click Create new promo code group at the top right of the Promo code groups tab. The create-group form opens.
| Field | Required | Notes |
|---|---|---|
| Group name | Yes | Public name (e.g., "Summer 2026 campaign", "Loyalty discounts") |
| Description | No | Internal notes about the group's purpose |
To stop here and create an organization-only group, click Create promo code group at the bottom. The new group shows up in the table without default settings.
Configure default settings
In the Default settings section, click Configure default settings. The form expands to show every default field you can pre-fill. The fields mirror the individual promo code form.
| Field | Notes |
|---|---|
| Redemption type | Percentage discount or Value discount |
| Value type | Per transaction / Per line item (Recommended) / Per quantity |
| Amount | Default discount amount |
| Allowed purchase dates | Available any dates or Available between dates |
| Purchase start / end date | Required when "Available between dates" is picked |
| Can be combined with other promo codes | Toggle |
| Can only be applied internally | Toggle |
| Applicable to | Multi-select with Add all games, Add all items, Add all gift card types quick-add buttons |
| Allowed booking dates | Same flow as the individual code form |
| Event start / end date | Required when restricted |
| Allowed booking time | Available any times or Available between times |
| Event start / end time | Required when restricted |
| Allowed days of the week | Mon–Sun checkboxes |
| Exclusion dates | Multi-date picker for blackout dates |
To stop using defaults later, click Remove default settings at the top of the section. The block collapses and the group goes back to organization-only.
Apply default settings to a new code
Open the Promo codes tab and click Create new promo code. On the form:
- Pick a group in the Promo code group dropdown.
- If the group has defaults, the Apply default settings from group toggle appears with an info alert reading This group has default settings configured. Enable the toggle below to apply these settings. This will overwrite the current settings for this promo code.
- Toggle it on to populate the form with the group's defaults.
- Customize any individual fields as needed.
The toggle is one-shot at create time. Editing the group's defaults later does not retroactively update codes already created — they keep the values they had at creation.
Add existing codes to a group
Click the three-dot menu on a group and pick Add promo codes to group. A modal opens with the title Add promo codes to [group name].
| Field | Notes |
|---|---|
| Promo codes | Multi-select with remote search. Type to find codes by name |
| Apply default settings to selected promo codes | Toggle. Renders only when the group has defaults. When on, the group's defaults overwrite the selected codes' settings |
Click Add to group to commit, or Cancel to discard. The button shows a spinner while applying.
Edit a group
Click the three-dot menu on the group and pick Edit promo code group. The same form opens prefilled. Change any field and click Update promo code group to save, or Cancel to discard.
Editing a group's defaults does not change codes already in the group. Default updates only apply to codes created later with the Apply default settings toggle on, or to existing codes you re-apply via Add promo codes to group with the toggle.
Delete a group
Click the three-dot menu on the group and pick Delete promo code group. The group is removed from the list. Codes assigned to the group keep their settings; they just lose their group assignment and become group-less.
Reference
Page header
| Element | Description |
|---|---|
| Top-right button | Create new promo code group |
| Total results | Count of groups |
| Per page | 5 / 10 / 25 / 50 |
List columns
| Column | What it shows |
|---|---|
| Group name | Group name. has default settings info badge when defaults are configured |
| Description | Internal description, or - |
| Promo count | Number of active promo codes assigned to the group |
| Actions | Three-dot menu (see below) |
Per-row actions
| Action | Effect |
|---|---|
| Edit promo code group | Opens the create/edit form prefilled |
| Add promo codes to group | Opens the add-codes-to-group modal |
| Delete promo code group | Removes the group; codes lose assignment but keep their settings |
Group form sections
| Section | Fields |
|---|---|
| Group details | Group name, Description |
| Default settings | Toggle: Configure default settings opens; Remove default settings closes. When open, full set of redemption, purchase, application, and booking-rule defaults |
| Purchase rules | Allowed purchase dates, Purchase start / end date |
| Usage and application rules | Combinable, Internal only, Applicable to, Quick-add buttons |
| Booking rules | Allowed booking dates / start / end, Allowed booking time / start / end, Allowed days of the week (Mon–Sun checkboxes), Exclusion dates |
Save buttons
| Mode | Buttons |
|---|---|
| Create | Cancel, Create promo code group |
| Edit | Cancel, Update promo code group |
Add promo codes to group modal
| Field | Notes |
|---|---|
| Promo codes | Multi-select with remote search; type to find codes |
| Apply default settings to selected promo codes | Toggle, renders only when the group has defaults |
| Cancel | Discards changes |
| Add to group | Commits the assignment. Shows spinner while applying |
Empty state
| State | Copy |
|---|---|
| No groups | "No promo code groups found." |
Good to know
- Groups are optional. You can run a thriving promo program without ever creating a group. Groups are about organization and convenience, not required structure.
- A code belongs to at most one group. Reassigning a code to another group removes it from its current group automatically.
- Default settings stamp the code at create time. Changes to a group's defaults later don't propagate to existing codes; they only affect new codes you create with the toggle on.
- Deleting a group is non-destructive to its codes. The codes keep their current settings and just become unassigned.
- The Promo count column counts active codes only. Archived codes are excluded.
- Add promo codes to group has an optional defaults sweep. Toggle the Apply default settings to selected promo codes option to overwrite the selected codes' settings with the group's defaults. Useful when adding codes to a campaign group and you want them all aligned.
- Quick-add buttons for Add all games, Add all items, and Add all gift card types speed up scoping defaults that should apply to your full catalog.
- Use organization-only groups when you want to bucket codes for reporting and filtering without forcing a default config. Skip the Configure default settings step and just create a name + description.
FAQ
Q: Can I change a group's default settings after promo codes have been created?
A: Yes, but the change only affects codes you create after that with the Apply default settings toggle on, or existing codes you re-apply via Add promo codes to group with the toggle. Existing codes already in the group keep their original settings until you explicitly re-apply.
Q: Can a promo code belong to more than one group?
A: No. Each code can be in at most one group. Reassigning to a new group automatically removes the previous assignment.
Q: Do I have to use groups?
A: No. Groups are optional and exist for organization and reusable defaults. You can create individual promo codes without ever touching the Promo code groups tab.
Q: What happens to codes when I delete a group?
A: The codes stay active with their current settings. They lose the group assignment and stop counting against the deleted group's Promo count. To reassign them, edit each code and pick a new group, or use Add promo codes to group on a different group.
Q: Can I bulk-add many codes to a group at once?
A: Yes. Click the three-dot menu on the group and pick Add promo codes to group. Type to search and pick as many codes as you need from the multi-select.
Q: Why don't my code's settings change when I update the group's defaults?
A: That's the intended behavior. Defaults stamp the code at create time. To re-stamp existing codes, open Add promo codes to group on the group, pick the codes, and turn on Apply default settings to selected promo codes.
Q: Can groups have eligibility rules as defaults?
A: No. Eligibility rules are configured per-code only. Groups handle the simpler discount and scoping fields.
Q: How is "Promo count" calculated?
A: It's the number of active (unarchived) promo codes assigned to the group. Archived codes don't count.