Overview
If you're using Hostaway as your PMS, you can create discount coupons directly in Hostaway and share them with your guests. The coupon feature enables you to configure discounts that can be applied to direct reservations and reservations from the Booking Engine.
Once a coupon is active in Hostaway, guests will see an option to enter a coupon code during the booking process on your CraftedStays direct booking site.
⚠️ Important: Discount codes and payments are managed entirely through Hostaway — not through CraftedStays. Your CraftedStays site surfaces the coupon field to guests during checkout, but the coupon creation, validation, discount calculation, and payment processing all happen within your Hostaway account.
Step 1: Create a Coupon in Hostaway
Log in to your Hostaway dashboard.
Go to Reservations and select Coupons.
Click Coupons > Add Coupon.
Fill in the coupon details in the pop-up window (see fields below).
Save the coupon. It will appear as active by default once saved.
Step 2: Fill in the Coupon Details
Name — Used to identify the coupon. All coupons on the same Hostaway account must have a unique name. No spaces or special characters are allowed — only letters and numbers.
Amount — The discount value to be applied. Type can be a percentage (e.g., 5%) or a flat value (e.g., $20). This discount applies to the base rate of the reservation.
Length of stay — The length of stay a reservation must meet for the coupon to apply. Options: Minimum, Equal, Maximum, or Between. The minimum accepted value is 1. For example, setting a minimum of 3 means the coupon only applies to bookings of 3 nights or longer.
Max uses — Optionally limit the number of times the coupon can be used. If left empty, there is no limit.
Check-in dates — Optionally limit the coupon to check-in dates within a specific time frame. Leave empty if you don't want to restrict it to a specific check-in period.
Validity — Defines the time window during which the coupon can be used. Has a "from" and "to" date range. Leave empty if you don't want to limit usage to a specific period.
Listings — Select which listings the coupon applies to. If no listings are selected, the coupon will be valid for all current and future listings. This setting is available to admin-level users only and applies to new coupons only.
Note: All conditions must be met simultaneously for a coupon to be applied. Only active coupons can be applied to reservations.
Step 3: How Guests Apply the Code on Your CraftedStays Site
Once your coupon is active in Hostaway, guests will see the option to enter it during the booking flow on your CraftedStays direct booking site.
The guest selects a listing and check-in/check-out dates.
An Add a coupon option will appear in the booking flow. The listing and dates must be selected first so Hostaway can calculate the correct discount.
The guest enters the coupon code. Hostaway validates it against all conditions and applies the discount automatically if valid. A confirmation message will appear and the total price will update.
The coupon discount appears as a separate line item in the price breakdown. The discount applies to the base rate, including any price for extra persons.
If the code doesn't meet all conditions, the system will show the guest why it cannot be applied.
Note on stacking: Coupons apply independently from other discounts such as weekly discounts. Only one coupon can be applied per reservation.
Important: Once a coupon has been applied to a direct reservation, it cannot be cancelled. If needed, the reservation must be cancelled and recreated.
Discount Codes and Payments Are Managed in Hostaway
Everything related to coupons and payments lives entirely within your Hostaway account — not in CraftedStays. Here's how the responsibilities are split:
CraftedStays | Displays the coupon field to guests during the booking flow on your direct booking site |
Hostaway | Creates and manages coupons, validates codes at checkout, calculates discounts, and processes guest payments |
If a guest has trouble with a coupon code — or if you need to edit, deactivate, or track usage — all of that is handled from your Hostaway dashboard under Reservations > Coupons. CraftedStays does not have the ability to create, modify, or troubleshoot coupons on your behalf.
Coupon Rules to Know
Coupons can only be created, deleted, or have their status changed by account owners, admin-level users, or users with rights to create or modify reservations.
Used coupons cannot be edited or deleted, but they can be activated or deactivated.
A coupon can only be deleted if it has never been used — double-check your settings before sharing a code with guests.
Expired or unused coupons can be edited. For unused coupons, all fields can be edited. For expired coupons, only Max uses, Validity, and Listings can be edited.
Coupons cannot be created with past validity or check-in dates.
Tips
Use distinct codes per campaign (e.g.,
RETURN20for past guests,SPRING15for seasonal promos) so you can track what's driving bookings.Set a max uses limit when sharing a code publicly to keep your discount exposure in check.
Since used coupons cannot be deleted, review the name and settings carefully before sharing a code with guests.
Related Resources