> For the complete documentation index, see [llms.txt](https://revhero.gitbook.io/revhero-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://revhero.gitbook.io/revhero-docs/your-hotels-performance/dashboard/occupancy.md).

# Occupancy

See how full your hotel is for the period, day by day, against last year and your target.

The **Occupancy** widget shows how full your hotel is across the selected period, as a percentage of your saleable inventory. Occupancy is the volume side of yield. [ADR](/revhero-docs/your-hotels-performance/dashboard/adr.md) is the price side.

Occupancy is the share of your available room nights that you sold. A **room night** is 1 room sold for 1 night. Rooms you close out, for maintenance or housekeeping, are removed from the available side. You set your available inventory in [Settings](/revhero-docs/your-hotels-setup/settings/room-types-and-inventory.md).

![Occupancy is a share of a fixed total](https://272652298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnzEa7YGji6t92Mfc0ZJ1%2Fuploads%2Fgit-blob-fc7c1c3f14e6167240344ac2f0ba88795a1058a5%2Foccupancy-is-the-share-of-rooms-you-sold.svg?alt=media)

*You sold 883 of the 1,050 room nights you had to sell. That share is your occupancy.*

## What you see

| Element                                                | What it means                                                                                       |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Headline value, purple (for example `84.10%`)          | Occupancy for the selected period                                                                   |
| **VS STLY** (for example `77.33%` `↑ 8.75%`)           | STLY means Same Time Last Year. It is the occupancy at the same point in last year's booking window |
| **LY Actual** (for example `79.14%` `↑ 6.27%`)         | The occupancy last year finally reached for the same period                                         |
| **Forecasting**, pink (for example `83.62%` `↑ 0.57%`) | The projected close. Expanded view only                                                             |
| Budget bar (for example `Budget: 80.00%` → `105.13%`)  | Your target and your attainment against it                                                          |

The collapsed card shows **VS STLY** and **LY Actual**. Click the ⤢ icon to expand it and see **Forecasting** and the **Reference Date**.

{% hint style="info" %}
You do not enter a budget occupancy directly. Load budget Room Nights and budget Revenue in [Budget & Target](/revhero-docs/your-hotels-performance/budget-target.md), and the occupancy target appears here on its own. Until then you see a purple **Add budget** link where the bar would be. This is the normal empty state, not a fault.
{% endhint %}

## The chart

Over a full month, or any longer range, you get a line chart. Occupancy is on the vertical axis, with 1 point for each stay date. The legend names 3 series.

| Line                                                             | What it shows                          |
| ---------------------------------------------------------------- | -------------------------------------- |
| **Purple**, labelled with the month in view (for example `JUNE`) | Daily occupancy for the current period |
| **Teal `STLY`**                                                  | The same dates last year               |
| **Pink dashed `FORECASTING`**                                    | The projection over future dates       |

Pick a short custom range of only a few days and the chart changes to paired bars. You get a purple current-period bar beside a teal STLY bar for each day. There is no forecast series in that shape.

Hold your pointer over any day to see its figures: the current date and value, the same date last year, and LY Actual. The expanded chart adds Forecasting.

Occupancy does not show Online Market Share. Only [Revenue](/revhero-docs/your-hotels-performance/dashboard/revenue.md) and [Room Nights](/revhero-docs/your-hotels-performance/dashboard/room-nights.md) do.

## How to read it

**Start with the figures.** Ahead of STLY means you are pacing better than last year at the same point. Ahead of LY Actual means you are on track to beat what last year finished at.

**Then read the shape of the chart.**

| What you see                                                 | What it means                                  | What to do                                                                                                                                          |
| ------------------------------------------------------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purple above teal early in the month, then crossing below it | Pace was strong but is now slowing             | Confirm it in [Booking Pace](/revhero-docs/your-hotels-performance/dashboard/booking-pace.md)                                                       |
| Midweek days well below your other days                      | Usually a normal leisure pattern               | Still check your rates and any events for those dates                                                                                               |
| Days climbing towards 100% well in advance                   | You may be squeezed late in the booking window | Review your walking plan, and consider closing your cheapest rate plans on the [Yielding Board](/revhero-docs/setting-your-rates/yielding-board.md) |

**Then read occupancy with price.** Strong occupancy with weak revenue means your rate is holding you back. Weak occupancy with a strong [ADR](/revhero-docs/your-hotels-performance/dashboard/adr.md) means you may have priced above the market. Read the 2 together to decide what to change.

**Then check the budget bar.** Attainment near or above 100% well before the period closes is a good position. Attainment behind as the period closes means you will miss the target. Act while there are still dates left to sell.

## If something looks wrong

| What you see                      | Usual cause                                                            | What to do                                                                                                             |
| --------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Occupancy above 100%              | Your available inventory is set lower than the rooms you actually sell | Correct it in [Settings](/revhero-docs/your-hotels-setup/settings/room-types-and-inventory.md)                         |
| 0% across many dates              | No rate plans published for those dates                                | Publish them on the [Yielding Board](/revhero-docs/setting-your-rates/yielding-board.md)                               |
| **Add budget** instead of the bar | You loaded no targets yet                                              | Set budget Room Nights and budget Revenue in [Budget & Target](/revhero-docs/your-hotels-performance/budget-target.md) |
| A sharp drop on 1 date            | A group cancelled, or rooms were blocked                               | Check the [Event Log](/revhero-docs/automation/event-log.md) for that date                                             |

## Common questions

**Are group bookings included?** Yes, by default. Use the **Segmentation** filter to exclude them.

**Are house-use rooms counted?** By default they are excluded from both sides of the calculation.

**Why is my attainment above 100%?** You are ahead of target. Review your targets if it stays that way.

## Related

* [ADR](/revhero-docs/your-hotels-performance/dashboard/adr.md) · [RevPAR](/revhero-docs/your-hotels-performance/dashboard/revpar.md) · [Room Nights](/revhero-docs/your-hotels-performance/dashboard/room-nights.md) · [Revenue](/revhero-docs/your-hotels-performance/dashboard/revenue.md)
* [Room types & inventory](/revhero-docs/your-hotels-setup/settings/room-types-and-inventory.md)
* [Reading a widget](/revhero-docs/your-hotels-performance/dashboard/widget-anatomy.md)

***

**Was this page helpful?** If something here is wrong, unclear or missing, email [support@revhero.com](mailto:support@revhero.com?subject=Manual%20feedback%20%5Ben%5D%20dashboard%2Foccupancy.md) and quote this page: `dashboard/occupancy.md`. Say what you expected to find — that is the part we can fix.
