> ## 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.

# Using the Calendar

> Navigate the job calendar, switch between views, apply filters, and jump to job details.

The job calendar gives you a visual overview of all scheduled work. This guide walks through everyday calendar tasks.

***

## Switching views

<Steps>
  <Step title="Open the calendar">
    Click **Calendar** in the sidebar navigation.
  </Step>

  <Step title="Choose a view">
    Use the view buttons in the top-right corner to switch between **Month**, **Week**, and **Day** views.
  </Step>

  <Step title="Navigate dates">
    Click the **left/right arrows** to move forward or back by one period. Click **Today** to return to the current date.
  </Step>
</Steps>

***

## Filtering jobs

<Steps>
  <Step title="Open the filter panel">
    Click the **Filter** button above the calendar to expand the filter options.
  </Step>

  <Step title="Select your filters">
    Choose any combination of:

    * **Branch** — view jobs for a specific branch
    * **Contractor** — show only one contractor's jobs
    * **Agent** — filter by the agent who raised the job
    * **Job type** — narrow to a specific trade or category
    * **Status** — show only jobs in a particular status
  </Step>

  <Step title="Apply">
    Filters take effect immediately. They persist when you switch views — switching from month to week keeps your filters active.
  </Step>
</Steps>

<Tip>
  Combine the **Branch** and **Contractor** filters to see a single contractor's workload for a specific office — useful for capacity planning.
</Tip>

***

## Opening a job from the calendar

Click any **job card** on the calendar to navigate directly to the job detail page. From there you can update the status, add case notes, or reassign the contractor.

***

## Reading the colour codes

Jobs are colour-coded by status:

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

Red jobs need immediate attention — they have exceeded their SLA response or completion window.