Skip to main content

Sub-tasks in BusyCal iOS

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.

The Task List shows three steps under Weekend in Kyoto and two under Pack an overnight bag.

Add a Sub-task​

  1. In the Task List, touch and hold a task.
  2. Tap Add Sub-task.
  3. Fill in the details and tap Done.

BusyCal saves the sub-task in the same calendar as its parent. 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.

  • Touch and hold a task, then tap Indent to place it under the previous task at the same level.
  • Touch and hold a sub-task, then tap Outdent to move it out one level, right after its former parent.
  • Touch and hold a task until it lifts, then drag it onto the middle of another task to make it a sub-task. To move a sub-task out or change its position, drop it between two tasks. Sliding your finger to the right between two tasks places it one level deeper where allowed.

Watch Save the walking route move under Weekend in Kyoto. Collapsing the parent hides all three steps.

With a hardware keyboard attached, you can also press ⌘-] to indent and ⌘-[ to outdent the focused task in the Task List. 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 choose the parent from Calendar below.

Choose a Parent Task​

You can move a task under an existing parent, or move a sub-task back to the top level, anywhere you choose its calendar. Each calendar in the list is followed by its open tasks that already have sub-tasks.

  • Touch and hold a task in the Task List or a calendar view, then tap Calendar.
  • Or open the task and tap Calendar. For a sub-task, this row shows the calendar followed by its parent task.

Tap a parent task to move the task under it, or tap a calendar to make it a top-level task in that calendar. Tapping a sub-task's current calendar moves it out from under its parent.

The Calendar menu shows a checkmark beside Weekend in Kyoto, the current parent of Save the walking route.

Show or Hide Sub-tasks​

Tap the arrow on a parent task's row in the Task List to collapse or expand its sub-tasks. BusyCal remembers what you've collapsed separately on each device.

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.
  • Your Show Items Due 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.
  • If a parent task is hidden by your Task List settings, any visible sub-task appears on its own.

Completing, Repeating and Deleting​

Completing​

  • Completing a parent task also completes its open sub-tasks.
  • 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 in the Task List filter options.
  • 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.

CalendarSub-tasksLevels
On My iPhone or On My iPadYesAny number
iCloud and other CalDAV servers, such as Fastmail and NextcloudYes, in task calendarsAny number
RemindersYesAny number
TodoistYesUp to 4 levels below a task
Google TasksYes1 level
Microsoft To Do (Microsoft 365 and Outlook.com)Yes, except the Flagged Emails list1 level
ExchangeNo

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 iPhone, iPad, and Mac, 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.

AppleScript and the AI & MCP Server are available on Mac only.