Shopping cart based Promo Codes

The Promo Codes feature allows to create and manage discount codes that guests can apply when making reservations. Each code includes configuration options like validity dates, visibility, discount type, and whether it applies to city tax.

Content:

  1. Location
  2. Table overview
  3. Creating a Promo Code
  4. Actions
  5. Editing a Promo Code
  6. Deleting a Promo Code
  7. Conclusion & Notes

Location

You can access the Promo Codes feature by navigating to:

  1. Account

  2. Settings

  3. Promo Codes

This opens the Promo Codes Configuration table, which lists all available promo codes for the property.


Table Overview

Each row in the table represents a promo code and includes the following columns: 

Column

Description

Promo Code

The code entered by the guest during booking

Single usage

Whether the promo code can be used only once per guest (True/False)

Discount type

Type of discount: Absolute (fixed value) or Percentage

Used

Indicates whether the code has already been used (True/False)

Discount amount

The value of the discount, shown with % or exact currency (CHF/EUR etc.)

Discount hidden

Boolean indicating the code will not be displayed to guests (True/False)

Discount city tax

Indicates whether the code also applies to city tax (True/False)

Active

The time window when the promo code is valid and can be used (Date&Time)

Booking

The valid booking window (i.e. stay period) for which the code applies (Date&Time)

 
Table overview (Codes in red indicate expired or invalid promo codes)
 

Creating a Promo Code

Click the “+ Add Promo Code” button to open the creation modal:

Field

Description

Promo code (Required)

The actual code guests will enter

Promo code type

Choose between Percentage (e.g. 10%) or Amount (e.g. €20)

Discount amount (Required)

Value of the discount

Code availability (Required)

Date and time range during which the code is active

Reservation dates

Date and time range for the stay period that the code applies to

Discount hidden

If checked, the code won’t be visible to guests only usable if known

Single usage

If checked, the code can only be used once

Discount city tax

If checked, the discount will also reduce the city tax amount

  
 Modal for creating a new Promo Code

Actions

Each code in the list has a context menu "..." with the following actions:

  • Edit: Opens the promo code in a modal to change its configuration

  • Delete: Removes the code from the system

Actions available for Promo Codes: 

image-png-Jun-19-2025-06-17-19-4662-AM copy 2


Editing a Promo Code

To edit an existing code:

  1. Click the ... button on the right side of the code row

  2. Select Edit

  3. The same modal as the "Create" flow will appear, pre-filled with the code’s details

  4. Make changes and click Save to apply them

 

This example displays the change of an invalid Promo Code, showing the error message


Deleting a Promo Code

To remove a promo code:

  1. Click the ... button on the right side of the code row

  2. Select Delete

  3. Confirm the deletion in the prompt (if shown)

Once deleted, the code can no longer be used or recovered!

 

Conclusion & Notes

  • A guest must manually enter the promo code during the booking process

  • Overlapping date windows (availability and reservation dates) may result in ineligible promo code

  • Expired codes will be visually flagged in the table with a red warning

  • Percentage-based and fixed-amount discounts cannot be combined on a single code