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

# Calendar View

> See every task schedule and routing schedule on a month calendar: what ran, what failed and what runs next.

The **Calendar** view shows your schedules on a month grid instead of a list. Each run appears on its day with its time, so you can see at a glance what already ran, whether it worked, and what runs next. Use it to spot busy days, gaps, and schedules that clash.

The calendar works for both **Task** and **Routing** schedules. It is available on a computer screen; on a phone, schedules are always shown as a list.

> [!NOTE]
>
> Required permission:
>
> * View schedule (Task)
> * View Schedule (Routing Schedule)

## Open the calendar

Open **Planning › Schedule**, pick the **Task** or **Routing** tab, and click **Calendar** beside **List**.

![Task schedules on the calendar](https://mintcdn.com/mileappv4/RuVvUPtsOpUeM2m6/images/v4/planning/schedule/task-calendar.png?fit=max\&auto=format\&n=RuVvUPtsOpUeM2m6\&q=85\&s=2a10639a479c3a3a55350c4ca569ff83)

1. **List / Calendar**: switch between the table and the calendar. The view you pick is kept in the page address, so a bookmark or a shared link opens the same view.
2. **Today**: jump back to the current month. Today's date is marked with a blue circle.
3. **Previous month / Next month**: move one month back or forward.
4. **Legend**: what each colour means. See [Run colours](#run-colours).
5. **A run**: the time and the schedule name. Click it to open the schedule's details.
6. **+N more**: a day shows its first three runs. Click **+N more** to see every run of that day.

**Filter** and **Search by name** work in the calendar too: only matching schedules are drawn. The calendar shows the schedules of the hub selected at the top of the page.

## Run colours

| Colour | Means |
| - | - |
| Blue | **Planned run**: the schedule will run at this time. Shown from today onward. |
| Green | **Last run succeeded**: the schedule's most recent run worked. |
| Red | **Last run failed**: the schedule's most recent run did not work. Open it to see why. |
| Grey | The most recent run ended another way, for example a routing schedule that was **skipped**. |

> [!NOTE]
>
> Before today, the calendar shows only each schedule's **last** run, not its full history. To check older runs, use the [list view](https://docsv4.mile.app/pages/planning/schedule/manage-task-schedules.md) or the routing schedule's [last execution](https://docsv4.mile.app/pages/planning/schedule/routing-schedule/managing.md).

Planned runs follow each schedule's repeat cycle and stay inside its active period: nothing is drawn before the start date or after the end date. Times are shown in your own time zone.

## See every run of a busy day

When a day has more than three runs, click **+N more**. A small window lists every run of that day in time order, with the date and the number of runs at the top.

![Every run of one day](https://mintcdn.com/mileappv4/RuVvUPtsOpUeM2m6/images/v4/planning/schedule/task-calendar-more.png?fit=max\&auto=format\&n=RuVvUPtsOpUeM2m6\&q=85\&s=ecb1a5dbaf10bb3594b52bc8abb7f990)

Click any run in the list to open its schedule.

## Open a schedule from the calendar

Click a run to open its schedule's details: what it creates, how it repeats, the times of day, the active period, the assignees and the status of the last run.

![Schedule details opened from the calendar](https://mintcdn.com/mileappv4/RuVvUPtsOpUeM2m6/images/v4/planning/schedule/task-calendar-detail.png?fit=max\&auto=format\&n=RuVvUPtsOpUeM2m6\&q=85\&s=1ecc3a92b9f841efb729daa0d11c2b57)

To change the schedule, close the window, switch to **List** and use **Edit** from the row's actions. See [Manage Task Schedules](https://docsv4.mile.app/pages/planning/schedule/manage-task-schedules.md).

## Routing schedules on the calendar

On the **Routing** tab the calendar works the same way. Each run shows when route optimization runs for that schedule.

![Routing schedules on the calendar](https://mintcdn.com/mileappv4/RuVvUPtsOpUeM2m6/images/v4/planning/schedule/routing-calendar.png?fit=max\&auto=format\&n=RuVvUPtsOpUeM2m6\&q=85\&s=92be0eef1e24e3dde616329aa31bf571)

A routing schedule whose last run was skipped, for example because there were no visits or its profile was deleted, shows that run in grey. See [Managing Routing Schedules](https://docsv4.mile.app/pages/planning/schedule/routing-schedule/managing.md) for what each outcome means.

## Limits

* The calendar loads up to 1,000 schedules. If you have more, a note appears above the calendar; use **Filter** or **Search by name** to narrow it down.
* The calendar is not shown on phones. Use the list instead.

## Related

* [Task Schedule](https://docsv4.mile.app/pages/planning/schedule/task-schedule.md)
* [Manage Task Schedules](https://docsv4.mile.app/pages/planning/schedule/manage-task-schedules.md)
* [Routing Schedule](https://docsv4.mile.app/pages/planning/schedule/routing-schedule/introduction.md)


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