What This Screen Does
This is where you create a discount voucher that customers can use to get money off a membership. Think of it like making a coupon code — you give it a name, set how much discount it offers, decide which memberships it applies to, and choose how long it stays valid. Once saved, customers can enter the voucher code when signing up for a membership to receive the discount.
How to Get There
Open the dashboard.
In the left-hand menu, click Vouchers.
Click the + New Voucher button in the top-right corner.
You are now on the Create a New Voucher screen.
Step-by-Step Guide
1. Enter Voucher Information
This is the first section on the page. It holds the basic details that identify your voucher.
Field | Required | What to Enter |
Voucher Name | Yes | An internal name to help you recognise this voucher (e.g. “Summer 2025 Promo”). Customers do not see this. |
Voucher Code | Yes | The code customers will type in to redeem the discount (e.g. |
2. Configure Usage & Availability
This section controls how many times the voucher can be used and where it is valid.
Field | Required | What to Enter |
Maximum Uses | Yes | The total number of times this voucher can be redeemed across all customers. Enter a whole number (minimum 1). |
Apply to First Payment Only | No | A toggle switch. When on, the discount only applies to the customer’s first payment. When off, the discount applies to every recurring payment for the life of the membership. Defaults to on. |
Gym Availability | Yes | Select one or more gym locations where this voucher can be accepted. It defaults to your currently selected gym. You must pick at least one. |
Applicable Membership Types | Yes | Choose which membership types this voucher can be used with. This field appears when one or fewer gyms are selected. You must pick at least one. Options include campaigns, contingents, punch cards, and personal training memberships. |
Note on Applicable Membership Types: This field only shows when you have selected one gym or fewer in the Gym Availability field. If you select multiple gyms, membership type filtering is not available.
3. Set the Discount Value
Here you decide how much of a discount the voucher gives. You can set either a fixed amount or a percentage — not both at the same time. Filling in one will automatically clear the other.
Field | Required | What to Enter |
Discount Amount | No | A fixed monetary discount (e.g. |
Discount Percentage | No | A percentage discount between 0 and 100 (e.g. |
You must fill in at least one of these two fields for the voucher to be useful.
If you type a value into Discount Amount, the Discount Percentage field will be cleared automatically, and vice versa.
4. Define the Validity Period
Set when the voucher becomes active and when it expires.
Field | Required | What to Enter |
Valid From | Yes | The date when the voucher becomes active. Pick a date from the date picker. Defaults to today. |
Valid To | No | The date when the voucher expires. Must be later than the Valid From date. Leave empty if the voucher should not expire. |
5. Save
Click the Create button at the bottom-right of the form.
The system will:
Validate all your inputs.
Create the voucher record via the API.
Redirect you back to the vouchers list.
You will see a green “Create success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Create"
|
v
Form validates all fields (Yup schema)
|
v
Clips value is converted to a number
|
v
API call: DiscountVoucherService.create({ body: formData })
|
v
Voucher record is created on the server
|
v
Success notification "Create success!" appears
|
v
You are redirected to /vouchers (the vouchers list)
Troubleshooting
“I filled everything in but the Create button does not work”
Double-check that all required fields are filled in. The form will not submit if anything is missing.
Look for small red error messages below the fields — they tell you exactly what needs fixing.
Make sure Maximum Uses is at least 1.
Make sure you have selected at least one gym and at least one membership type.
“I see ‘Please select at least one gym’”
You must select at least one gym location in the Gym Availability dropdown.
If no gyms appear in the list, your account may not have any gym locations set up yet. Contact your administrator to add a gym first.
“I see ‘Please select at least one membership type’”
You need to check at least one membership type in the Applicable Membership Types dropdown.
If the dropdown is empty, it means there are no active membership types in the system. Create a campaign, contingent, punch card, or personal training membership type first, then come back to create the voucher.
This field only appears when you have one or fewer gyms selected. If you selected multiple gyms, this field is hidden.
“I cannot set both a discount amount and a percentage”
This is by design. A voucher can offer either a fixed amount off or a percentage off, but not both.
When you type a value into one field, the other is automatically cleared.
Decide which type of discount works best for your promotion and fill in only that field.
“The ‘Valid To’ date shows an error”
The Valid To date must be later than the Valid From date.
If you set Valid From to today, the Valid To date must be tomorrow or later.
If you do not want the voucher to expire, leave the Valid To field empty.
“I do not see the Applicable Membership Types field”
This field only appears when you have one or no gyms selected in the Gym Availability dropdown.
If you have selected two or more gyms, the membership type filter is hidden. To see it again, reduce your gym selection to one.
“I got an error after clicking Create”
A red error message will appear. Read it carefully — it usually describes the problem.
Common causes: a duplicate voucher code that already exists, a server timeout, or a missing required field.
If the error is unclear, try again. If it keeps happening, contact support with the error message.
“My voucher was created but customers say the code does not work”
Verify that the Voucher Code you created matches exactly what the customer is typing (codes may be case-sensitive).
Check that today’s date falls between the Valid From and Valid To dates.
Make sure the customer’s membership type is one of the Applicable Membership Types you selected.
Confirm the voucher has not already reached its Maximum Uses limit.
Ensure the customer is signing up at a gym that is listed in Gym Availability.
“The currency symbol looks wrong”
The currency symbol is pulled from your chain’s default currency setting.
If it is showing the wrong symbol, ask your administrator to check the chain settings and update the default currency.