> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1club.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Occupancy

> The Occupancy report under Analytics > Bookings - how much of the open hours of your areas, coaches, and classes was booked, an hour-by-weekday grid for every area, revenue per hour, and the hours that sit empty.

The **Occupancy** report (**Analytics** > **Bookings** > **Occupancy**) shows how much of what your gym offers was booked: the open hours of your areas, the hours of the coaches members book, and the places in your classes. A grid of the week shows which hours fill and which sit empty, area by area, and what each hour earns. Owners and managers use it to set prices and opening hours, and to decide where to add or cut sessions.

## When to use it

* **Find the empty hours** - a padel gym sees its areas 95% booked from 18:00 to 21:00 on weekdays and under 30% from 13:00 to 16:00, and puts an off-peak price on the quiet hours.
* **Compare areas** - a tennis gym's **Per area** table shows its indoor hall at 41% while the outdoor areas sit near 80%, and the grid for the hall alone shows it is empty every weekday morning.
* **Price by what an hour earns** - switching the grid to **Revenue per hour** shows a climbing gym that its busiest evening hours earn less per hour than the weekend mornings, because evenings are mostly members on a membership.
* **Check a promotion worked** - with **Compare with** on **Previous period**, each area shows how its occupancy moved after a midweek discount.

## How occupancy is measured

Occupancy is the hours booked over the hours available:

* **Hours available** - the hours both the club and the area were open, less the area's blocks and the club's. A blocked hour counts as neither available nor booked.
* **Hours booked** - hours of bookings on the area that were not cancelled, inside its available hours, with classes and [Events](https://docs.1club.ai/events/events.md) running on it included. Overlapping bookings count once.

Each area is measured against its own hours. The same rule gives the area occupancy on this page, on [Home](https://docs.1club.ai/home/metrics.md#occupancy), on the [Clubs](https://docs.1club.ai/analytics/clubs.md) reports, and in the [daily email](https://docs.1club.ai/home/overview#daily-email), so the figures match everywhere. Classes are measured in places (seats booked over class capacity), and coaches in the hours they are open to be booked by members.

Because availability comes from opening hours, keep the hours of your clubs and [areas](https://docs.1club.ai/settings/areas.md) and your [area blocks](https://docs.1club.ai/schedule/area-blocks.md) accurate, or the percentages will not mean much. See [Analytics definitions](https://docs.1club.ai/analytics/definitions.md#places) for every figure.

## Filters

* **Period**, **Group by**, and **Compare with** - as on every report (see [Analytics overview](https://docs.1club.ai/analytics/overview#the-filter-bar)).
* **Area type** (under **Filters**) - narrows the areas measured, for example to your padel areas only. The instructor figures are not an area's, so they stay as they are.
* **Areas shown** - **All areas** together, or **One area** with an **Area** selector, for the grid.
* The club in the breadcrumb narrows everything to one club.

## Cards

Each card appears only when there was something to fill, so a studio that only runs classes sees **Class Occupancy** rather than two 0% cards for hours it does not sell:

| Card | What it shows |
| - | - |
| **Occupancy** | The average of the measures below, each counted once. Shown when more than one applies. |
| **Area Occupancy** | Booked area hours over available area hours. |
| **Instructor Occupancy** | Booked hours of member-bookable coaches over their open hours. |
| **Class Occupancy** | Booked class places over class capacity. Cancelled bookings and classes, and classes with no capacity limit, are left out. |
| **Area Capacity**, **Instructor Capacity** | Booked hours over available hours, for example `120 / 400 h`. |

With a comparison on, the rates move in percentage points.

## Charts

* **Occupancy Over Time** - booked hours as bars and the occupancy rates as lines, per day, week, or month.
* **Occupancy by Area Type** and **Occupancy by Instructor Type** - where you have spare capacity or a bottleneck, with `booked / available h` under each bar.

## The occupancy grid

**Occupancy by hour** is a grid of the week: a row for every hour any day was open and a column for each weekday, starting Monday. Each cell is colored by how much of that hour was booked over the period and shows the percentage. Hours you were closed are marked **Closed** rather than 0%, and blocked time is shown on hover.

Hover a cell to see the hours booked against the hours available, what the hour earned, and its figure in the compared period. Click a cell to list the bookings, classes, and Events behind that hour of the week, each with its **Date**, **Time**, **What**, and **Status**, and linking to the record.

### Revenue per hour

Switch **Grid shows** from **Occupancy** to **Revenue per hour** to color the grid by what each hour earned per available hour, against the period's best hour. This tells you which hours earn the most, not only which are full.

Revenue here is area revenue: what the area's bookings earned, excluding tax and net of refunds, including seats on classes held there and its share of Events held there. A booking covered by a membership adds nothing, because that money is the membership's.

### Most unbooked hours

Under the grid, **Most unbooked hours** lists the five open hours of the week with the most time left unbooked over the period, with their occupancy. Click one to open what was booked in it. These are the hours to fill with a [promotion](https://docs.1club.ai/sales/promotions.md) or an off-peak [pricing rule](https://docs.1club.ai/settings/pricing-rules.md).

## Per area

The **Per area** table lists every area with:

| Column | What it shows |
| - | - |
| **Area**, **Area type** | The area and its type (**Untyped** when none is set). |
| **Hours available**, **Hours booked**, **Occupancy** | As defined [above](#how-occupancy-is-measured). |
| **Busiest slot** | The hour of the week with the highest occupancy over the period. |
| **Revenue** | The area's revenue over the period. |
| **Revenue per hour** | Revenue earned on the area's booked time inside its available hours, divided by those hours. Money on a booking held entirely outside them counts in **Revenue**, not here. |

A **Total** row sums the areas. With a comparison on, each area's occupancy and revenue show how they moved. Hover a column heading for its definition. **Export** downloads the table, for the period, club, and area type on screen, as Excel or CSV.

## Worked examples

### Off-peak pricing at a padel club

The club picks **Last 3 months** and reads the grid for **All areas**. Weekdays from 18:00 to 22:00 sit above 90%, while 14:00 to 16:00 sit under 25%. **Most unbooked hours** lists Tuesday to Thursday at 14:00 and 15:00. The owner adds an off-peak price for those hours and, a month later, opens the report with **Compare with** on **Previous period** to see the occupancy move.

### One underused area

In the **Per area** table, a tennis gym's indoor hall reads 41% against 80% for its outdoor areas. The manager switches **Areas shown** to **One area** and picks the hall: it is full in the evenings but empty every weekday morning. Clicking a morning cell shows only a few one-off bookings, so the gym moves its morning coaching group indoors and opens the outdoor areas to members instead.

### Class places at a reformer studio

A studio with no areas set up sees only **Class Occupancy** and **Instructor Occupancy**. Class occupancy reads 92% over the last month, so the owner adds a class at the busiest time rather than promoting the existing ones.

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| The grid is empty | No areas, or no open hours in the period for the areas shown | Check the club's and areas' opening hours, the club in the breadcrumb, and the **Area type** filter. |
| Occupancy looks far too high or too low | Opening hours or blocks are missing or wrong | Correct the hours under **Settings** > **Clubs** and on each [area](https://docs.1club.ai/settings/areas.md), and check [area blocks](https://docs.1club.ai/schedule/area-blocks.md). |
| An hour reads **Closed** but you were open | The opening hours set on the club or the area leave that hour out. An area with no hours on it or its club counts as open 07:00-22:00 | Correct the hours on the club or area. |
| A busy hour earns little in **Revenue per hour** | Most of its bookings are covered by memberships, whose money counts on the membership | This is expected. Read membership revenue on [Revenue analytics](https://docs.1club.ai/analytics/billing.md). |
| A card is missing | There was nothing of that kind to fill in the period (no areas, no bookable coaches, or no classes with a capacity) | This is expected. |

## Related

* [Schedule and instructor analytics](https://docs.1club.ai/analytics/schedule.md) - The other Bookings, Check-ins, Classes, and Instructors reports.
* [Clubs analytics](https://docs.1club.ai/analytics/clubs.md) - Occupancy trends per location.
* [Home metrics](https://docs.1club.ai/home/metrics.md#occupancy) - The Occupancy chart on Home.
* [Areas](https://docs.1club.ai/settings/areas.md) - Areas, their types, and opening hours.
* [Area blocks](https://docs.1club.ai/schedule/area-blocks.md) - Time an area is closed for booking.
* [Pricing rules](https://docs.1club.ai/settings/pricing-rules.md) - Off-peak and peak prices.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.