Overview
If you're using Hospitable as your PMS, you can create promo codes directly in Hospitable and share them with your guests. Direct Basic and Direct Premium customers can generate promotions offering both percentage-based and fixed rate discounts, with optional restrictions to control how they're used.
Like length of stay discounts, percentage-based discounts apply only to the nightly rate. If your properties have resort, community, or management fees that are bundled into the nightly rate, you may want to communicate this to guests — for example, "Up to 10% off on..."
Once you have an active promo code, guests will see the text "I have a discount code" in the booking widget on your CraftedStays site. Clicking it reveals a text field where they can enter and submit a code.
⚠️ Important: Discount codes and payments are managed entirely through Hospitable — not through CraftedStays. Your CraftedStays site surfaces the discount code field to guests during checkout, but the promo code creation, validation, discount calculation, and payment processing all happen within your Hospitable account.
Note: Promo codes can only be applied by guests during the booking flow. Hosts cannot make adjustments to bookings to apply promo codes once a booking is created.
Step 1: Create a Promo Code in Hospitable
Go to the Direct Promo Codes page in Hospitable.
Click the + Add New button in the top right corner.
Enter the promo code. Codes can be from 3 to 64 alphanumeric characters (e.g.,
WELCOME10). You can generate as many individual codes as you like for each promotion — using different codes per campaign or placement will let you track performance separately.Enter the discount amount. If it's a fixed amount, specify the currency. If you have properties with different currencies, you'll need to create a separate promotion for each currency, but they can share the same code.
Set any optional restrictions (see below).
Select the properties this code applies to. Note: you won't be able to select a property if its currency doesn't match or if it's already using the same code.
Optional Restrictions
Hospitable lets you add conditions to control how and when a promo code can be used:
Expiration date — The last date a promo code can be used to request a new booking.
Qualifying stay dates — Set a start date, or a start and end date range, to control which nights can be booked using the code. All nights of the itinerary must fall within the period for the code to be applied.
Number of uses — The total number of times this code can be redeemed across all guests. If a booking is declined or cancelled, it does not count as a use.
Minimum length of stay — Require a minimum number of nights for the code to apply.
Minimum booking value — Set a minimum reservation value to qualify for the promo code, calculated as the total nightly rate plus fees.
Discount stacking — Toggle this on if you want to restrict bookings to only one discount at a time. When enabled, if a reservation already qualifies for a length of stay discount (weekly, monthly), the promo code field will be hidden in the booking widget.
Step 2: How Guests Apply the Code on Your CraftedStays Site
Whenever you have an active promo code, guests will see the text "I have a discount code" when making a booking on your CraftedStays direct booking site.
The guest searches for available dates and selects a property.
During the booking flow, they will see the text "I have a discount code."
Clicking that text reveals a text field where they can enter the promo code.
Hospitable validates the code against any restrictions you've set. If the code passes, the discount is applied. If it doesn't qualify, Hospitable will explain to the guest specifically why — for example, if the itinerary doesn't meet a minimum night stay requirement.
Discount cap: Regardless of the amount set, Hospitable caps the discount at 100% of the combined nightly rate (excluding all fees). For example, if you set a $250 promo code and a guest selects a two-night stay at $100 per night, the code would be worth only $200 on that reservation.
Discount Codes and Payments Are Managed in Hospitable
Everything related to promo codes and payments lives entirely within your Hospitable account — not in CraftedStays. Here's how the responsibilities are split:
CraftedStays | Displays the "I have a discount code" field to guests during the booking flow on your direct booking site |
Hospitable | Creates and manages promo codes, validates codes at checkout, calculates and applies discounts, and processes guest payments |
If a guest has trouble with a promo code — or if you need to edit, deactivate, or track usage — all of that is handled from your Hospitable Promotions dashboard. CraftedStays does not have the ability to create, modify, or troubleshoot promo codes on your behalf.
Tips
Use distinct codes per campaign (e.g.,
SUMMER10for a seasonal promo,EMAIL10for newsletter subscribers) to track which channels are driving bookings.Use the expiration date to create urgency — set a near-term cutoff even if the qualifying stay dates extend further out.
Enable discount stacking restrictions for exclusive codes you don't want combining with length of stay discounts.
If you have multi-currency properties, remember to create separate promotions per currency — they can share the same code name.