---
title: Configuration
url: 'https://docs.joomdonation.com/oscalendar/using-back-end/configuration'
markdown: 'https://docs.joomdonation.com/oscalendar/using-back-end/configuration.md'
date: '2026-10-28'
description: '[TOC] Overview The OS Calendar Configuration page is accessible via Components → OS Calendar → Configuration or via the Configuration shortcut on the Dashboard. It is organised into seven tabs. Upgrade Tab Field Description Download ID Enter the Download ID obtained from your account at joo…'
taxonomy:
  category:
    - docs
---

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

# Configuration

\[TOC\]

## Overview

The OS Calendar **Configuration** page is accessible via **Components → OS Calendar → Configuration** or via the **Configuration** shortcut on the Dashboard. It is organised into seven tabs.

---

## Upgrade Tab

| Field | Description |
|---|---|
| **Download ID** | Enter the Download ID obtained from your account at joomdonation.com. Required for automatic updates via Joomla's built-in updater. |

---

## Application Tab

### Booking Settings

| Field | Description |
|---|---|
| **Enable Reservation** | Enable or disable the online booking feature globally. When disabled, customers cannot make reservations. |
| **Operation Mode** | **Standalone** (default): manage your property directly in OS Calendar; OS Property is not needed. **Linked**: synchronise properties with OS Property. See **Operating Modes**. |
| **Only Registered Users Can Book** | When set to Yes, only logged-in Joomla users can submit a booking request. Guests will be prompted to log in or register before proceeding. |

### Cancellation Policy

| Field | Description |
|---|---|
| **Allow Cancel the Booking Request** | Allow customers to cancel their own bookings from the front-end (My Orders / My Bookings page). The refund amount follows the **Cancellation Policy** of the rate plan (see **Cancellation Policies**). |
| **Allow Cancel Before (days)** | The minimum number of days before the check-in date within which cancellation is permitted. E.g. set to `3` to allow cancellation only if the check-in is more than 3 days away. |

### Notifications

| Field | Description |
|---|---|
| **Send Notification** | When enabled, OS Calendar sends automated email notifications to the customer and site administrator when a booking is submitted, confirmed, or cancelled. |

### Special Notes

| Field | Description |
|---|---|
| **Special Notes** | Free-text notes or instructions shown on the booking form (step 1) and the booking confirmation page. Useful for house rules, check-in procedures, etc. |

### Date & Time Formats

| Field | Description |
|---|---|
| **Date Format** | The date format used throughout the component (e.g. `Y-m-d`, `d/m/Y`). |
| **Time Format** | The time format used throughout the component (e.g. `H:i`, `h:i A`). |

---

## Payment Tab

| Field | Description |
|---|---|
| **Currency** | Default currency code displayed in the booking form and order details (e.g. `USD`, `EUR`). |
| **Currency Symbol Position** | Show the currency symbol before or after the amount, or hide it. |
| **Money Format** | Number format applied to every amount shown on the front-end, in emails and in invoices: `1 000 000.00`, `1 000 000,00`, `1.000.000,00` or `1,000,000.00`. |
| **Use CAPTCHA** | Enable CAPTCHA on the booking form to prevent spam submissions. |

---

## Pricing Tab

| Field | Description |
|---|---|
| **Tax Rate (%)** | Default tax percentage applied to all booking orders. |
| **Include Tax in Price** | When enabled, prices displayed to the customer already include tax. |
| **Minimum Nights** | Minimum number of nights required for a booking. |
| **Maximum Nights** | Maximum number of nights allowed for a single booking. |

---

## Other Tab

| Field | Description |
|---|---|
| **Date Search in Property Types** | Only relevant when OS Property is installed. Restricts the availability date search to selected OS Property property types. |
| **Real Time Offset (hours)** | Time zone offset in hours relative to server time. Used for accurate current-date calculations. |

---

## Invoice Tab

| Field | Description |
|---|---|
| **Invoice Prefix** | Prefix added to invoice numbers (e.g. `INV-`). |
| **Show Invoice** | Show or hide the invoice download link on the order detail page. |
| **Invoice Notes** | Custom notes printed at the bottom of the PDF invoice. |
| **Company Name / Address / Phone / Email / Logo** | Company information printed on PDF invoices. |

---

## Custom CSS Tab

| Field | Description |
|---|---|
| **Custom CSS** | Your own CSS rules. When you save, they are written to `media/com_oscalendar/assets/css/custom.css`. If that file is not empty, it is loaded automatically on every OS Calendar front-end layout after the default stylesheet, so your rules override it. |

> The former **Enable Card Types** and **Use HTTPS** options were removed: payment gateways now support all card types, and HTTPS is determined by your site URL.

---

After making changes, click **Save** (or **Apply** to save without closing) in the toolbar.

 [ ](https://docs.joomdonation.com/oscalendar/using-back-end/dashboard) [](https://docs.joomdonation.com/oscalendar/using-back-end/properties)

---

## Navigation

- Parent: [Using Back-end](https://docs.joomdonation.com/oscalendar/using-back-end.md)
- Previous: [Dashboard](https://docs.joomdonation.com/oscalendar/using-back-end/dashboard.md)
- Next: [Properties](https://docs.joomdonation.com/oscalendar/using-back-end/properties.md)
