What are Coupons?
Coupons are promo codes that guests can enter at checkout to receive a discount on a booking. Each coupon has its own code, discount amount, validity period, customer eligibility rule, and list of calendars where it can be used.
You can create and manage coupons from Settings → Coupons.
Why Do You Need Coupons?
- Run promotions without changing prices: Offer seasonal, launch, partner, or limited-time discounts while keeping your normal calendar pricing intact.
- Target specific customers: Make offers available to everyone, new customers, existing customers, or first-time bookers.
- Control where discounts work: Choose exactly which calendars accept each coupon.
- Set an offer window: Use start and end dates so a promotion automatically becomes invalid outside its intended period.
- Work with deposits: Coupon discounts are applied before a deposit amount is calculated.
How Do I Create a Coupon?
Step-by-Step Instructions
Step 1: Open the Coupons Page
Click the gear icon in the left rail and select Coupons.
You can also go directly to /settings/coupons.
The Coupons menu is only visible if your role has the coupons.read permission.
Step 2: Click “Create Coupon”
Click Create Coupon in the page header. If you have not created any coupons yet, the empty state also provides the same button.
Step 3: Enter the Coupon Code
Enter the code guests will type during checkout in the Coupon Code field.
This field is required. Keep the code short and easy to enter.
Note: Coupon codes are case-sensitive as stored, so guests need to enter the correct casing.
Step 4: Add a Coupon Name
Enter an internal name in Coupon Name, such as Eid Offer, Summer Campaign, or New Customer Discount.
The name is required and appears on the coupon card in your dashboard. Guests do not see it.
Step 5: Set the Discount
Choose how the coupon should reduce the booking price.
| Field | Options | Purpose |
|---|---|---|
| Discount Types | Fixed or Percentage | Determines how the discount is calculated |
| Amount | Number greater than 0 | Sets the value of the discount |
For a Percentage coupon, the amount cannot be greater than 100.
Step 6: Choose Who Can Use the Coupon
Use Coupon Applies To to control which guests qualify for the discount.
| Option | Who Qualifies |
|---|---|
| Everyone | No customer restriction |
| New Customers | Guests with no previous booking in the workspace |
| Existing Customers | Guests who have previously booked with the workspace |
| First Booking Only | Guests making their first booking with the workspace |
Customer eligibility is checked using the guest’s booking email against previous bookings in the workspace.
Step 7: Set the Validity Dates
Choose when the coupon can be used.
- Starting Date: Required. The coupon cannot be used before this date.
- Ending Date: Optional. After this date, the coupon is rejected.
If you leave the Ending Date empty, the coupon can continue running without an automatic expiry date.
Step 8: Select Calendars
Use Select Calendars to choose the calendars where the coupon can be applied.
The field supports multiple calendars and loads additional calendars as you scroll.
Important: A coupon with no calendars selected cannot provide a discount.
Step 9: Confirm the Coupon
Click Confirm. The new coupon will appear on the Coupons page.
How Do I Enable Coupons on a Calendar?
Creating a coupon is only one part of the setup. The calendar itself must also be configured to accept coupons.
Go to Dashboard → Manage Calendars, open the calendar, select the Pricing tab, and turn on Apply Coupon.
The Apply Coupon option requires a plan that includes Coupon Management.
For a coupon to work at checkout, both conditions must be true:
- The calendar has Apply Coupon enabled.
- The coupon has that calendar selected in its Select Calendars field.
Managing Existing Coupons
Each coupon appears as a card showing its name, coupon code, validity date, and the calendars where it applies.
The coupon code also has a one-click copy button.
| Action | What It Does | Permission |
|---|---|---|
| Edit | Open the coupon and change its configuration | coupons.update |
| Duplicate | Create a copy to use as the starting point for another offer | coupons.update |
| Delete | Permanently remove the coupon after confirmation | coupons.delete |
Actions your role cannot perform are hidden. If you have no available actions, the action menu itself does not appear.
How Coupon Discounts Are Calculated
Percentage Discount
A percentage coupon removes the specified percentage from the discountable booking amount.
For example, a 20% coupon on a $100 discountable amount reduces the price by $20.
Fixed Discount
A fixed coupon subtracts a specific amount from the booking total.
The discount is capped at the total amount, so a coupon can never make the booking price negative.
When Is a Coupon Accepted?
When a guest enters a coupon during booking, Timetics AI checks four things:
- The coupon exists.
- The current date is inside its validity window.
- The coupon is attached to the calendar being booked.
- The guest matches the selected audience rule.
If any of these checks fail, the coupon provides no discount.
What Does the Coupon Discount Apply To?
The discountable amount includes:
- Base booking price
- Extras
- Guest fees
- Group multipliers
Recurring bookings are handled differently. The recurring portion is excluded unless the calendar’s Recurring setting has Apply discount to recurring events set to Yes.
How Coupons Work with Deposit Booking
When both coupons and Deposit Booking are enabled, the coupon is applied before the deposit is calculated.
For example, suppose a booking costs $100, the guest uses a 50% coupon, and the calendar requires a 30% deposit.
- Original price: $100
- After 50% coupon: $50
- 30% deposit: $15
- Guest pays now: $15
- Remaining due: $35
Permissions
| Permission | Allows |
|---|---|
coupons.read | View the Coupons page |
coupons.create | Create coupons |
coupons.update | Edit and duplicate coupons |
coupons.delete | Delete coupons |
Prerequisites
- The appropriate coupon permissions for the action you want to perform
- A plan that includes Coupon Management to enable coupons on calendars
- At least one calendar with a price above zero
Important Notes
- There is no All Calendars shortcut. Every calendar where a coupon should work must be selected manually. Calendars created later must also be added manually. Learn more.
- New Customers and First Booking Only currently behave the same way. Both check whether the guest’s email has any previous bookings in the workspace.
- There is no usage limit. Coupons do not currently have an overall redemption limit or a per-guest usage cap.
- Ending Date is optional. A coupon can continue indefinitely if you do not provide one.
- An invalid date range can currently be saved. The form does not enforce that the ending date must come after the starting date. However, an already-closed validity window will fail when the coupon is checked at checkout.
- Deleting a coupon does not change previous bookings. Existing bookings keep the discount that was recorded when the coupon was used.
- Coupon codes are case-sensitive. Guests should enter the code using the exact casing in which it was created.