Calendar view
Route: /org/tasks?view=calendar · Permission: View Tasks
1. What the calendar view is
Tasks placed on a month grid by due date, alongside two things that are not tasks at all: the organization's public holidays and the current user's approved leave.
That combination is the point. A deadline that lands on a holiday, or in the middle of someone's leave, is obvious here and invisible everywhere else.
| Calendar (this page) | List | Timelines | |
|---|---|---|---|
| Positions tasks by | Due date | Grouping | Start → due, as a bar |
| Shows duration | No — a single day | No | Yes |
| Shows holidays and leave | Yes | No | No |
| Shows dependencies | No | No | Yes |
| Editable | No | Yes | Yes |
The calendar filters to tasks that have one. A project where nobody sets due dates shows an empty month, correctly.
2. What is drawn on the grid
| Layer | Source | Appearance |
|---|---|---|
| Tasks | The filtered board | Coloured pill; click opens the detail panel |
| Holidays | The organization's holiday calendar | A red background wash across the whole day, with an umbrella icon |
| Leave | The signed-in user's upcoming leave | An amber block, 🌴 Leave: <subject>, spanning start to end |
| Non-working days | The organization work week | The cell is shaded |
Leave comes from the signed-in user's own upcoming leave. Looking at this calendar tells you when you are away — not when the assignee of a task is away.
Non-working days come from the configured work week, falling back to Saturday and Sunday when none is configured.
3. Using the calendar — step by step
Step 1 · Navigate
| # | Control | Does |
|---|---|---|
| 1 | prev · next · today | Move the range |
| 2 | Title | The current period |
| 3 | month · week · list | Switch layout |
The three layouts are a month grid (the default), a time-grid week, and a list of the month.
Step 2 · Read a task pill
The pill's colour is the status colour, falling back to the priority colour, then to blue. Hovering opens a tooltip with the task's status, priority and category.
Step 3 · Open a task
Clicking a task pill opens the detail panel. Holiday and leave blocks are not clickable.
Step 4 · Cope with a busy day
A day shows at most three events before collapsing the rest behind a "+n more" link.
4. Field reference
| Element | Behaviour |
|---|---|
| Task pill | Colour: status → priority → blue. All-day. Click opens the detail panel |
| Holiday | Rendered as a background wash, so tasks still show on top of it |
| Leave | A normal block spanning start to end date |
| Shaded cell | A non-working day per the work week |
| Now indicator | Shown in the week layout |
| dayMaxEvents | Three, then "+n more" |
What the calendar does not do
| Not available | Why it matters |
|---|---|
| Dragging a task to another day | Due dates are changed in the list, table or detail panel |
| Creating a task from a day cell | Use Add Task |
| Grouping | The group-by control has no effect on this view |
| Start dates and duration | Only the due date positions a task. Use Timelines |
Every other view edits something. This one only navigates. Filters still apply, so it reflects whatever the filter bar has narrowed to — but nothing on it can be changed.
5. The admin contract
| Prerequisite | Without it |
|---|---|
| Tasks with due dates | An empty calendar |
| Holidays configured | No holiday washes |
| A work week configured | Falls back to Saturday and Sunday as non-working |
| Approved leave | No leave blocks |
| Status colours set | Pills fall back to priority colour, then blue |
6. Downstream
Nothing. The calendar reads; it writes nothing back.
7. Don't confuse this with…
| Screen | What it shows |
|---|---|
| Task calendar (this page) | Task due dates, plus holidays and your leave |
| Task Timelines | Start-to-due bars with dependencies and milestones |
| Orbit calendar | Meetings and events, synced with Google and Microsoft |
| Leave calendar | The authoritative leave record; this view only borrows from it |
8. Troubleshooting
| Symptom | Cause |
|---|---|
| The calendar is empty | No task in the filtered set has a due date |
| A task is missing | It has no due date, or a filter excludes it |
| Cannot drag a task to another date | The view is read-only |
| A day shows "+2 more" | Three events per day is the cap |
| A colleague's leave is missing | Only the signed-in user's leave is drawn |
| Weekends are not shaded as expected | The work week configuration decides which days are non-working |
| Group by does nothing | Grouping is not applied in this view |
Related
- Task Timelines — the view with duration and dependencies
- List view — where due dates are edited