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

# Read the Appointment Calendar

> How to read the dock calendar: what each appointment block shows, and what its colors and icons mean.

**Where to find it:** `Dock Scheduling → Appointments`

Every appointment at your facility appears on the calendar as a colored block. Once you know what its text, colors, and icons mean, you can read the state of your whole dock at a glance.

This page covers reading an individual appointment. To filter the calendar, search it, or switch between month, week, and day views, see [find an appointment](/facilities/finding-appointments).

## What an Appointment Shows

Each block holds three pieces of text:

* **Top line (bold)**: the order and reference numbers. Owlery lists the requested order numbers first, then the load number, then the load's reference numbers, then reference numbers from any linked orders. Duplicates are removed, and a long list is cut off with an ellipsis — hover to see all of it.
* **Bottom left**: the start time in 24-hour format, followed by the timezone it's shown in, like `13:30 MDT`. All-day appointments don't show a time.
* **Bottom right**: the customer name. When your own organization is the customer, Owlery shows the shipper or supplier from the linked order instead.

Two icons can appear on the block itself:

* **A direction arrow**: sits to the left of the order numbers. An arrow pointing in means inbound — a drop-off at your facility. An arrow pointing out means outbound — a pick-up from your facility.
* **A red error icon**: appears in the top-right corner when the appointment has at least one unresolved exception. These are the same exceptions you'd see on the **Exceptions** tab.

## Reading the Colors

Each appointment carries two colors: the fill, and a thicker stripe down its left edge. Between them they trace the single path every appointment moves through, with the fill covering the first half ([the booking](/dock-scheduling/overview#appointment-lifecycle)) and the stripe covering the second (the truck).

### The Fill: Where the Booking Stands

* **Red**: **Not Scheduled**, or an **Unknown** state.
* **Amber**: **Proposed**, and waiting on someone to confirm it.
* **Green**: **Confirmed**.

The fill color is also used for the block's text and a thin border, so it's easy to spot even on a busy day.

### The Left Stripe: Where the Truck Is

* **Gray**: **Not Arrived**.
* **Orange**: **Arrived** and on site.
* **Blue**: being **Loaded** or **Unloaded**.
* **Green**: **Departed**.

### Reading Them Together

Once an appointment turns green, the fill has done its job and stops changing — from there you watch the stripe. So green with a gray stripe means confirmed, but nobody has arrived yet. Green with a blue stripe means the truck is at the dock right now. Green with a green stripe means it's finished and gone.

| What you see       | Where it is on the path  |
| ------------------ | ------------------------ |
| Red fill           | Not Scheduled or Unknown |
| Amber fill         | Proposed                 |
| Green fill         | Confirmed                |
| Gray left stripe   | Not Arrived              |
| Orange left stripe | Arrived                  |
| Blue left stripe   | Loaded or Unloaded       |
| Green left stripe  | Departed                 |

<Tip>
  Scan for red and amber first. Those appointments haven't cleared booking yet, so they're the ones that need someone to act before a truck shows up.
</Tip>

For more on the stages themselves, see [the appointment lifecycle](/dock-scheduling/overview#appointment-lifecycle).

## Getting More Detail

Hovering over an appointment opens a tooltip with a quick summary:

* The order and reference numbers, in bold and untruncated.
* **Customer**: the customer name.
* The appointment time.
* **Appointment status**: with a colored dot matching the fill.
* **Equipment status**: with a colored dot matching the left stripe.
* The direction of the stop, with an icon.

The equipment status wording follows the type of stop. A pick-up reads **Equipment Loaded**, and a drop-off reads **Equipment Unloaded**.

Clicking an appointment opens a drawer with its full details. Blocked and closed ranges aren't appointments, so they can't be clicked.

## Blocked and Closed Ranges

Not every block on the calendar is an appointment. **Striped gray blocks** mark times your facility isn't taking trucks, labeled with the facility name and either **Closed** or **Blocked**. A full-day closure reads **Closed all day**; a partial block shows the blocked time window instead. These aren't clickable.

<CardGroup cols={2}>
  <Card title="Block a Dock Slot" icon="ban" href="/facilities/block-a-dock-slot">
    Hold one door for a maintenance window or a parked trailer.
  </Card>

  <Card title="Holiday & Closure Dates" icon="calendar-xmark" href="/facilities/holiday-and-closure-dates">
    Override the facility's hours on a specific date.
  </Card>
</CardGroup>
