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

# Calendar

> View and manage jobs on an interactive calendar with month, week, and day views — filter by branch, contractor, agent, and job type.

The job calendar gives you a visual timeline of all scheduled and in-progress work. Switch between views, filter by team or trade, and jump straight to any job from the calendar.

***

## Views

<Tabs>
  <Tab title="Month view">
    See the full month at a glance. Each day cell shows job cards colour-coded by status. Days with many jobs show a count badge — click to expand.
  </Tab>

  <Tab title="Week view">
    A seven-day layout with more detail per job. Each card shows the job reference, contractor, and status. Useful for planning the week ahead.
  </Tab>

  <Tab title="Day view">
    A single-day view listing every job scheduled for that date. Shows full job details including address, assigned contractor, and current status.
  </Tab>
</Tabs>

***

## Filters

Narrow down what appears on the calendar using the filter bar:

| Filter         | Options                                                          |
| -------------- | ---------------------------------------------------------------- |
| **Branch**     | View jobs for a specific branch or all branches                  |
| **Contractor** | Show only jobs assigned to a particular contractor               |
| **Agent**      | Filter by the agent who raised the job                           |
| **Job type**   | Filter by job category (e.g. plumbing, electrical, general)      |
| **Status**     | Show only jobs in a specific status (e.g. accepted, in progress) |

Filters persist across view changes — switching from month to week keeps your active filters.

***

## Navigation

* Use the **arrow buttons** to move forward or back by one period (month, week, or day)
* Click **Today** to jump back to the current date
* Click any **job card** on the calendar to open the full job detail page

***

## Colour coding

Jobs are colour-coded by their current status so you can spot priorities at a glance:

| Colour | Status                         |
| ------ | ------------------------------ |
| Blue   | New / unassigned               |
| Amber  | Assigned / awaiting acceptance |
| Green  | In progress                    |
| Grey   | Completed                      |
| Red    | SLA breached or overdue        |

<Tip>
  The calendar automatically highlights SLA-breached jobs in red so you can prioritise overdue work without running a separate report.
</Tip>
