Sub-tasks
Break a large task into smaller steps by adding sub-tasks under it. In the Task List, sub-tasks sit indented under their parent task with a smaller checkbox. A sub-task can also have sub-tasks of its own where your calendar service allows deeper nesting.

Add a Sub-task
Select one open task in a calendar view or the Task List, choose File > New Sub-Task, and type a title. When you start from a calendar view, BusyCal opens an Info Panel window for the new sub-task.
In the Task List, you can also select a task and choose Edit > Add Sub-task, Control-click the task and choose Add Sub-task, or Control-click the + button at the top of the list and choose New Sub-Task.

BusyCal adds the sub-task after the parent task's other sub-tasks in the same calendar. A sub-task is a regular task. It can have its own due date, alarms, priority, tags, and notes, and it appears on the calendar on its due date.
Turn an Existing Task into a Sub-task
You can reorganize existing tasks directly in the Task List.
- Select a task and choose Edit > Indent or press
⌘-]to place it under the previous task at the same level. - Select a sub-task and choose Edit > Outdent or press
⌘-[to move it out one level, right after its former parent. - Drag a task onto another task to make it a sub-task. To move a sub-task out or change its position, drag it between two tasks.
Watch Save the walking route move under Weekend in Kyoto. Collapsing the parent hides all three steps.
Indent and Outdent are also in the Control-click menu, and both work on multiple selected tasks at once. If you select several tasks in a row and indent them, they all move under the previous unselected task at that level. Moving a parent task carries its sub-tasks along with it.
Because a sub-task always belongs to its parent's calendar, Indent is only available when that previous task is in the same calendar. To place a task under a parent in another calendar, drag it onto that parent or use the Calendar menu below.
Choose a Parent Task from the Calendar Menu
You can move a task under an existing parent, or move a sub-task back to the top level, from the Calendar menu. Control-click the task and open Calendar, or choose Edit > Calendar. Each calendar appears with its color dot, followed by its open parent tasks marked with a matching checkbox.
- Pick a parent task to move the selected task under it.
- Pick a calendar to make the task a top-level task in that calendar. Choosing a sub-task's current calendar moves it out from under its parent.
The menu lists open tasks that already have sub-tasks. If a calendar has more than 20 of them, the rest appear under More Parent Tasks….
The calendar picker in the Info Panel offers the same calendars and parent tasks in a searchable list. For a sub-task, it shows the parent task next to the calendar name.
Show or Hide Sub-tasks
Click the arrow at the end of a parent task's title in the Task List to collapse or expand its sub-tasks. BusyCal remembers what you've collapsed separately on each Mac.
Sorting and Filtering
Sub-tasks stay grouped under their parent task in every sort order.
- When you sort by due date, a parent task uses the earliest due date among itself and its open sub-tasks. If a sub-task is overdue, its parent appears under Overdue even when the parent has no due date of its own.
- Changing the Task List date range keeps a parent and its sub-tasks together. For example, if you show tasks due by today and a sub-task is due today, its parent appears with it even if the parent is due later.
- When you sort manually, drag sub-tasks into any order under their parent. Manual order for tasks and sub-tasks syncs through iCloud, other CalDAV servers, and Microsoft To Do (except the Flagged Emails list). With other services, each device keeps its own order.
- A search or Smart Filter can show a parent with its sub-tasks even when only the parent matches. If only a sub-task matches, it can appear without its parent.
Completing, Repeating and Deleting
Completing
- Completing a parent task also completes its open sub-tasks. Choose Edit > Undo or press
⌘-Zto reopen all of them in one step. - Reopening a sub-task also reopens its parent task if the parent was completed.
- A completed sub-task stays under its open parent. Whether you see it depends on Show completed Tasks in Task Settings.
- Completing a repeating parent task saves a completed copy of the task and its sub-tasks, then moves it to its next date with its sub-tasks open again. Dated sub-tasks move forward by the same amount. After the last occurrence, the parent and its sub-tasks stay completed.
- Completing a parent task that has a repeating sub-task completes that sub-task with the rest and stops it from repeating.
Deleting
- Deleting a sub-task removes only that sub-task and any sub-tasks under it. Its parent task stays untouched.
- Deleting a parent task deletes all of its sub-tasks too. BusyCal asks first and tells you how many sub-tasks will be deleted.
- When a repeating parent task has another occurrence ahead, deleting only this occurrence moves the task to its next date and keeps its sub-tasks. Deleting all occurrences or the final occurrence also deletes its sub-tasks.
Moving a Parent Task to Another Calendar
When you move a parent task to another calendar, its sub-tasks move with it.
If the destination calendar allows fewer levels of sub-tasks, deeper sub-tasks move up under the nearest parent above them that still fits. If the calendar doesn't support sub-tasks at all, all of them become regular tasks in that calendar.
Where Sub-tasks Sync
Sub-tasks work in writable calendars whose service can store them. On calendars that don't support sub-tasks, or once a task reaches its calendar's depth limit, the sub-task commands are unavailable.
| Calendar | Sub-tasks | Levels |
|---|---|---|
| On My Mac | Yes | Any number |
| iCloud and other CalDAV servers, such as Fastmail and Nextcloud | Yes, in task calendars | Any number |
| Reminders | Yes | Any number |
| Todoist | Yes | Up to 4 levels below a task |
| Google Tasks | Yes | 1 level |
| Microsoft To Do (Microsoft 365 and Outlook.com) | Yes, except the Flagged Emails list | 1 level |
| Exchange | No | |
| A calendar shared from another Mac on your network | Yes, when the sharing Mac also runs a version of BusyCal with sub-tasks | Any number |
If nesting a task would exceed its calendar's depth limit, BusyCal lets you know and leaves the task where it is.
A few services handle sub-tasks differently.
- In Reminders, Apple doesn't give third-party apps access to the sub-tasks you create in the Reminders app, so BusyCal manages its own. A sub-task you create in BusyCal shows up in the Reminders app as a separate reminder, and the parent and its sub-tasks carry a short
@taskid:or@parenttaskid:line in their notes. BusyCal hides those lines in its own notes field and uses them to rebuild the hierarchy on your other devices, so leave them in place. Indented sub-tasks created in the Reminders app still aren't visible to BusyCal. See Using BusyCal with Reminders. - In Microsoft To Do, BusyCal stores each sub-task's parent link and manual position in task metadata that syncs between copies of BusyCal. Microsoft's own To Do apps don't read that metadata, so sub-tasks appear there as separate tasks in Microsoft To Do's own order.
- In Todoist, moving a task to a different Todoist list in BusyCal recreates it in Todoist, so its Todoist comments and activity history don't carry over. See Using BusyCal with Todoist.
Shortcuts
On Mac, iPhone, and iPad, Shortcuts includes Add Sub-task, List Sub-tasks, and Set Parent Task, and adds Parent Task ID to task results. Existing task actions such as Update Task, Defer Task, Complete Task, Reopen Task, and Delete Tasks accept a returned sub-task directly.
The Delete Tasks action in Shortcuts asks for confirmation before deleting a task that has sub-tasks and tells you how many sub-tasks are included.
On Mac only, AppleScript (createSubtask, listSubtasks, setTaskParent) and the AI & MCP Server (create_subtask, list_subtasks, set_task_parent) also work with sub-tasks. If a deletion would also remove sub-tasks, confirm it in BusyCal or Shortcuts.
