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

# Calendar View

> Visual calendar display of shifts by day and creator

## Layout

* **Rows** — creators
* **Columns** — days
* **Cells** — shifts for that day and creator

## Display density

Use the **S / M / L** toggle to change the calendar density:

| Mode | Name | Description |
| - | - | - |
| **S** | Compact | Minimal cell height, more rows visible at once |
| **M** | Default | Standard cell height |
| **L** | Comfortable | Larger cells with more shift details visible |

<Tip>
  Choose Compact mode when you need an overview of many creators at once. Switch to Comfortable for a detailed look at individual shifts.
</Tip>

## Visual indicators

### Coverage bar

On a normal day, each cell shows a 24-hour bar:

* **Green** — has an assigned employee
* **Gray** — no shift (open hours)

Open time is calculated from the real intervals in the selected time zone. Overlapping shifts are combined, and 23- or 25-hour days around daylight-saving changes use their actual duration. On those variable-length days, AgencyKey hides the misleading fixed 24-segment bar but keeps the exact interval rows and open-time total visible.

### Status cards

| Card | Meaning |
| - | - |
| **Open Shifts Xh Ym** | There are uncovered hours |
| **All Shifts Filled** | The whole real day is covered |

### Shift details

Below the bar you'll see:

* Time (e.g., 09:00 - 17:00)
* Repeat icon (if recurring)
* Employee name and avatar

## Navigation

* **Scroll left** — past days (load automatically)
* **Scroll right** — future days (load automatically)
* **Date filter** — jump to a specific date

Date headers stick to the top of the calendar while you scroll horizontally, so you always see which day each column belongs to.

## Filtering

| Filter | Description |
| - | - |
| Date | Jump to date |
| Group | Show creators assigned to one team group or its subgroups |
| Creator | Show one creator within the selected group scope |
| Reset | Clear all filters |

### Coverage outside your employee scope

An interval can appear as **Occupied** without an employee name when the shift contributes to real creator coverage but the employee identity is outside your data scope. It reduces open time correctly, but it has no edit or delete actions. This avoids exposing an employee while also avoiding a false uncovered interval.

## Loading and recovery

If the first schedule load fails, the calendar shows **Retry**. A failed later request preserves the last confirmed schedule where possible. Group and creator filters are validated together before loading, so an invalid pair is not silently expanded to a broader calendar.

## Quick actions

Hover over a shift:

* **Empty cell** — plus icon to create shift
* **Filled shift** — edit and delete icons

An unusual open interval in a repeated daylight-saving hour, or one whose boundary is more precise than a minute, remains visible but has no create action. Its exact time and time-zone offset explain the interval; this prevents the minute-based editor from saving a different time.


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