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

# The Calendar

> Read your reservations as a timeline or a day-by-day agenda, and move around by date.

The **Calendar** tab shows your reservations on a timeline. Each unit in the
property you're viewing gets its own row, and every stay appears as a bar across
the dates it covers.

The Calendar has two views, switched with the toggle at the top of the screen:
the **Timeline** (the default, described just below) and the **Agenda** — a
compact [day-at-a-glance list](#agenda-view-the-day-at-a-glance) of who arrives,
leaves, and is staying.

## How to read the timeline

* **Rows are units.** The unit's code (or name) labels each row down the left
  side. Dates run across the top.
* **Bars are reservations.** A bar spans a booking's check-in to check-out on
  that unit's row. Tap a bar to open the reservation.
* **Dashed lines mark each day.** A faint dashed vertical line falls on the
  check-in time of every day, so the space between two lines is one night —
  count the lines across an empty stretch to read how many nights a unit is
  free.
* **Units / Staff toggle.** Above the timeline you can switch between **Units**
  (the default — one row per unit) and **Staff** (one row per teammate, for
  seeing assigned work across the schedule).

<Tip>
  When you're viewing more than one property at once, units are grouped under a
  collapsible header for each property so you can tell them apart.
</Tip>

## What the colors mean

Reservation bars are colored by status, and task blocks (in the **Staff** view)
by their status. A collapsible **Legend** at the bottom of the Calendar maps
each color to its label — tap **Legend** to expand it. It has two groups:

* **Reservations** — Requested, Confirmed, Checked In, Checked Out, Cancelled,
  and No Show. See [reservation statuses](/reservations/view-a-reservation#reservation-statuses)
  for what each one means.
* **Tasks** — Pending, In Progress, Completed, and Cancelled.

## Moving around by date

The timeline opens on the current week. To move:

* **Today** — the **Today** button snaps the timeline back to the current week.
* **Previous / Next** — the chevron buttons (**\<** and **>**) step the view
  backward or forward by the window you're currently looking at.
* **Jump to a date** — the <Icon icon="calendar-days" /> in the top-left corner
  opens a date picker; choose a date to jump straight there.
* **Pan and zoom** — drag the timeline to pan across dates, and pinch to zoom in
  and out, from a single day up to a whole year at a glance. Short tasks are
  hidden when you're zoomed too far out for them to be legible — a brief job
  appears only once you zoom in close enough to see it, while longer jobs stay
  visible from a wider view.

<Note>
  On a computer, the left and right arrow keys also step the timeline back and
  forward while the Calendar is open.
</Note>

## Agenda view — the day at a glance

The timeline is best for spans and gaps. When you just want to know **who
arrives, who leaves, and who's staying** on a given day, switch to the
**Agenda** view with the view toggle at the top of the Calendar. It lists a
single day, grouped into three sections:

* **Arrivals** — guests checking in that day, with their check-in time.
* **Departures** — guests checking out that day.
* **In-house** — guests staying through the day (they arrived earlier and leave
  later), each showing the date they check out.

Every row shows the unit, the guest's name, the time, and a status badge, and
any pending **prep and cleaning tasks** for that stay appear just beneath it.
Tap a row to open the reservation.

Move between days with the **\<** and **>** arrows, and tap the date at the
top — labelled **Today** on the current day — to jump back to today. When a day
has nothing booked, the Agenda shows **Nothing scheduled**.

## Add a reservation

To enter a booking yourself — a walk-in, a phone reservation, or anything that
didn't come from a connected channel — tap **New Reservation** (the **+** button
in the top-right of the Calendar).

<Steps>
  <Step title="Tap New Reservation">
    The **New Reservation** button opens a blank reservation form.
  </Step>

  <Step title="Fill in the stay">
    Set the **Status**, the **Check-in – Check-out** dates, the **Check-out
    Time**, and an optional **Expected Arrival Time**. Then pick the
    **Property** and the **Unit** the guest is staying in.
  </Step>

  <Step title="Add the guest">
    Under **Guest**, enter the booker's **First name** (required), and
    optionally their **Last name**, **Phone**, and **Email**.
  </Step>

  <Step title="Add stay details (optional)">
    Record the number of **Adults**, **Children**, and **Infants**, whether
    they're **Travelling with a pet**, and any **Accessibility** or **Dietary**
    notes the housekeeper should know.
  </Step>

  <Step title="Tap Create">
    The reservation is saved and appears on the timeline on its unit's row.
  </Step>
</Steps>

<Note>
  **Create** stays disabled until the required fields are filled: the check-in
  and check-out dates, the **Property**, and the guest's **First name**.
</Note>

## Opening a reservation

Tap any reservation bar to open its details, where you can view the stay, the
guests on it, the tourist tax, and linked tasks. See
[View a reservation](/reservations/view-a-reservation) for a tour of the details
sheet and [Manage guest details](/reservations/manage-guests) for the guests on
a stay.

## It remembers your place

The Calendar keeps its position as you move around the app. If you scroll to a
future week and then switch to **Chats** or **Tasks**, you'll come back to the
same spot rather than being reset to today.

To deliberately return to the current week, tap the **Calendar** tab again while
you're already on it — this snaps the timeline back to today.

## When there are no units yet

A unit is a rentable space — a room, apartment, or villa. Until your property has
at least one unit, the Calendar has no rows to draw, so it shows **No units yet**
with a **Create your first unit** button.

<Steps>
  <Step title="Tap Create your first unit">
    This takes you to your property's unit setup.
  </Step>

  <Step title="Add a unit">
    Give it a code, a name, a type, and a maximum number of guests.
  </Step>
</Steps>

Once a unit exists, it appears as a row on the timeline. Reservations for it
show up automatically from your connected channels, and you can also
[add one yourself](#add-a-reservation). Full steps:
[Manage units](/properties/manage-units).

## Next

<CardGroup cols={2}>
  <Card title="View a reservation" icon="calendar" href="/reservations/view-a-reservation">
    Open a booking to see its guests, tax, and tasks.
  </Card>

  <Card title="Manage guest details" icon="user-pen" href="/reservations/manage-guests">
    View and edit the guests on a stay.
  </Card>
</CardGroup>
