Summary: The Task Calendar is a timeline view that displays your tasks across dates

General Information

What is the Task Calendar?

The Task Calendar is a timeline view that displays your tasks across dates, showing when tasks start and when they’re due. It provides a visual way to see task durations, deadlines, and scheduling at a glance, helping you understand your workload over time.

When should I use the Calendar view?

Use the Calendar view when you need to:

• Visualize task timelines and deadlines
• Plan work across days, weeks, or months
• Identify scheduling conflicts or busy periods
• Track task progress over time
• Get a time-based perspective on your workload

Basic Usage

How do I navigate the calendar?

1. Use the left and right arrow buttons in the top left to scroll through time periods
2. The calendar will automatically navigate to the next time period based on your current view (day, week, month, or task range)
3. The visible date range is displayed as a date pill between the navigation arrows
4. Click on the time view buttons (Today, Week, Month, Tasks) to quickly jump to different time perspectives

What are the different calendar views?

The calendar offers four different time perspectives:

1. Today – A focused view of just the current day’s tasks
2. Week – Shows a 7-day week view with tasks spread across the days
3. Month – Displays the full month with tasks positioned on their respective days
4. Tasks – Automatically centers the view on the date range of your tasks

How do I read the task timeline?

1. Each task appears as a horizontal bar on the calendar
2. The left edge of the bar represents the start date
3. The right edge represents the due date
4. The width of the bar shows the duration of the task
5. Color-coding indicates task status (see below)
6. Hover over a task to see additional details like days remaining or days overdue

How do I view task details?

1. Click on any task bar to open a detailed task panel on the right side
2. The task panel shows comprehensive information about the task:
   • Name and description
   • Start and due dates
   • Status and priority
   • Completion percentage
   • Assigned personnel
   • Tags
3. From the task panel, you can:
   • View all task details
   • Click “View Details” to navigate to the full task page
   • Click “Close” to return to the calendar

What do the different task colors mean?

• Red section: Overdue portions of tasks
• Dark background with progress indicator: In-progress tasks
• Gray background: Completed tasks

How can I identify today’s date?

1. Today’s date is highlighted with a blue background in the date header
2. A vertical “Today” line appears on the calendar at today’s date
3. A “Today” pill appears below today’s date in the header

How do I know when calendar data is loading?

When task data is being loaded or filtered:

1. A loading spinner will appear in the center of the calendar view
2. The spinner indicates that tasks are being retrieved or updated
3. The calendar will become interactive again once loading is complete

Advanced Features

How do I group tasks in the calendar?

1. Click the “Group By” dropdown in the top right of the calendar header
2. Select one of the grouping options:
   • No Grouping (all tasks in a flat list)
   • Units (group by organizational unit)
   • Status (group by task status)
   • Priority (group by task priority)
   • Assigned To (group by assigned person)
   • Type (group by task type)
3. Tasks will be organized into labeled sections
4. By default, all groups are expanded

How can I see task progress on the calendar?

1. Each task bar shows a visual representation of its progress
2. The darker portion of the bar indicates completed work
3. The percentage complete is also listed in the task detail panel

How can I see overdue tasks?

Overdue tasks (past their due date but not completed) are highlighted with:

1. A red section showing the overdue portion of the task
2. An “overdue” indicator showing how many days past the deadline it is
3. Red styling on hover to indicate the overdue status

How do I see who’s assigned to tasks?

1. Click on a task to view its detailed panel
2. The assigned personnel are listed in the “Assigned to” section
3. Profile pictures and names of assigned team members are displayed

Why are some view buttons disabled?

The Today, Week, and Month view buttons will be disabled if there are no tasks that fall within the current day, week, or month. This helps guide you to views where your tasks are actually located.

Troubleshooting

The calendar seems cluttered with too many tasks

1. Use the filter options above the calendar to reduce the number of visible tasks
2. Try grouping tasks by different criteria to organize them better
3. Focus on a shorter time period by using the Today or Week views instead of Month

I can’t see tasks when navigating in the “Tasks” view

1. Continue navigating in the desired direction to find your tasks
2. The “Tasks” view will show a continuous range of dates even when no tasks exist for those dates
3. A message will indicate when there are no tasks in the current view
4. Try switching to Today, Week, or Month view to jump directly to standard time periods

The task bars are too small to read

1. Click on the task to see its full details in the task panel
2. Try using the Week or Today view for a more focused, zoomed-in perspective
3. Task bars expand slightly on hover to make them easier to read
4. The detailed view provides complete information

I can’t find a specific task on the calendar

1. Use the search function above the calendar
2. Try different grouping options to reorganize the view
3. Ensure the task has date information (start or due date)
4. Check if the task’s dates fall within the visible date range
5. Try the “Tasks” view which automatically centers on all tasks with dates

Why is my view frozen during loading?

If the calendar appears frozen while the loading spinner is visible, this is normal behavior. Complex filtering operations or large data sets may take a moment to process. The interface will become responsive again once loading is complete.

Best Practices

How should I use the Calendar view effectively?

1. Use the different time views (Today, Week, Month, Tasks) based on your planning needs
2. Use grouping to organize related tasks
3. Focus on specific date ranges when planning your week or month
4. Click on tasks to get detailed information when needed
5. Use the calendar alongside other views (Board, Table) for complete task management
6. Regularly check for overdue tasks highlighted in red

How can I plan my workload using the Calendar?

1. Look for periods with many overlapping tasks to identify busy times
2. Notice gaps in the timeline where new tasks could be scheduled
3. Pay attention to approaching deadlines (look ahead a week or two)
4. Check task durations to understand time commitments
5. Use grouping by assigned person to balance workload across team members