---
title: Promotions
url: 'https://docs.joomdonation.com/oscalendar/using-back-end/promotions'
markdown: 'https://docs.joomdonation.com/oscalendar/using-back-end/promotions.md'
date: '2026-10-11'
description: '[TOC] Overview Promotions let you offer discounts, either automatically or with a promo code that guests enter on the booking search form. Open Components → OS Calendar → Pricing → Promotions. Promotion List Filter by property, status and type. You can also open Featured Promotions and the Usage vi…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/02.using-back-end/10.promotions/docs.md) 

# Promotions

\[TOC\]

## Overview

**Promotions** let you offer discounts, either automatically or with a promo code that guests enter on the booking search form.

Open **Components → OS Calendar → Pricing → Promotions**.

## Promotion List

Filter by property, status and type. You can also open **Featured Promotions** and the **Usage** view of each promotion.

## Adding or Editing a Promotion

| Section | Field | Description |
|---|---|---|
| **Basic Information** | **Title, Code, Description** | Name, promo code, and description. |
|  | **Type** | The discount type: **Percentage**, **Fixed Amount**, **Free Nights** or **Upgrade**. |
|  | **Discount Value / Max Discount** | The discount amount and, for percentage discounts, an optional maximum. |
| **Applies To** | **Property, Room Types, Rate Plans** | Where the promotion can be used. |
| **Validity** | **Valid From / To** | Dates in which the promotion can be redeemed. |
| **Date Restrictions** | **Booking Date / Stay Date ranges** | Limit by when the booking is made and by the stay dates. |
| **Rules** | **Min Stay (nights), Min Booking Amount** | Conditions that the booking must meet. |
|  | **Stackable, Priority** | Whether it can be combined with other promotions, and the order in which promotions are applied. |
| **Usage Limits** | **Total / Per User** | Maximum number of uses overall and per customer. |
| **Publishing** | **Featured, Published** | Highlight the promotion and make it active. |

## Promotion Usage

Open **Usage** to see where and when a promotion was used: booking, customer, email, booking total and date.

> > > > **Needs verification:** How the Upgrade and Free Nights types are shown to guests and applied to the booking total.

 [ ](https://docs.joomdonation.com/oscalendar/using-back-end/availability-calendar) [](https://docs.joomdonation.com/oscalendar/using-back-end/cancellation-policies)

---

## Navigation

- Parent: [Using Back-end](https://docs.joomdonation.com/oscalendar/using-back-end.md)
- Previous: [Availability & Inventory](https://docs.joomdonation.com/oscalendar/using-back-end/availability-calendar.md)
- Next: [Cancellation Policies](https://docs.joomdonation.com/oscalendar/using-back-end/cancellation-policies.md)
