[TOC]
In OS Calendar, all pricing and availability data is stored at the room level. The Enable Room option in Configuration → Application tab determines how rooms are exposed to the site administrator and to customers.
When Enable Room = No, customers book a property directly — there is no room-selection step on the front-end.
Internally, OS Calendar still creates one representative room per property automatically. This representative room is invisible to customers and acts as the single pricing and availability unit for the whole property. As an administrator you set the price and manage the availability calendar for this single unit, but you do not see or manage the room name or room fields — only the price and calendar views are relevant.
When to use this mode: ideal for single-unit rentals such as a villa, apartment, holiday home, or any property where there is only one bookable space.
When Enable Room = Yes, each OS Property property can have multiple distinct rooms managed inside OS Calendar. Customers select a specific room when booking.
To access a property's room list, navigate from a booking order or use the Room management menu. The room list shows:
| Column | Description |
|---|---|
| ID | Room ID |
| Room Name | Name of the room |
| Number of People | Maximum capacity of the room |
| Price | Base nightly price for the room |
| Ordering | Display order (drag to reorder when sorted by Ordering) |
| Published | Published / Unpublished status |
When to use this mode: ideal for hotels, guest houses, serviced apartments, B&Bs, or any property that offers several distinct bookable units under one roof.
| Field | Description |
|---|---|
| Room Name | Name of the room (e.g. "Double Room", "Suite 101"). Supports translation. |
| Photo | Upload a photo of the room. Stored in images/oscalendar/rooms/. |
| Room Number | Optional room number or identifier. |
| Max Adults | Maximum number of adult guests allowed in this room. |
| Max Children | Maximum number of children allowed in this room. |
| State | Published / Unpublished. Only published rooms appear on the front-end calendar. |
| Description | A description of the room. Supports translation. |
Note: The Room Name, Photo, Room Number, Description, and State fields are only shown when Enable Room = Yes. When rooms are disabled, only Max Adults and Max Children are displayed on the representative room's edit form.
Each room row provides quick action buttons:
| Button | Action |
|---|---|
| Set up Price (tag icon) | Opens the price setup page for this room. |
| Edit (pencil icon) | Opens the room edit form. |
| Availability Calendar (calendar icon) | Opens the availability calendar for this room. |
If the Joomla multilingual feature is enabled on your site, the Room Name and Description fields support per-language translations. An additional Translation tab appears in the room edit form showing language tabs for each published Joomla language.
Rooms can be reordered by dragging the handle in the # column. Make sure the list is sorted by Ordering (ASC) and click Save Order to persist the new order.