Module guide
Tasks
The atomic unit of work in Atlas.
Overview
A task carries everything a unit of work needs: title, description, priority, status, due and start dates, estimates, assignees, labels, attachments, threaded comments, dependencies, subtasks, custom links, recurrence, reminders, and approval state. Every view in Atlas renders tasks one way or another, so the task is the one object worth learning first.
Highlights
The capabilities worth knowing before you dive in.
Important to know
Limits, permissions, and sharp edges to keep in mind.
- A task status is a short text key of up to 48 characters. The default board columns are To do, In progress, Done and Blocked, and each column you add in Settings > Board columns brings a key of its own.
- Versions are an opt-in optimistic lock. If you PATCH with a stale version, the API returns 409.
- Archived is not the same as deleted. Archive hides a task from default views; delete moves the task to Trash, where it can be restored for 30 days. Deleting also offers an undo for a few seconds straight afterwards.
How to use it
The primary workflow, start to finish.
- Press ⌘K and type the task title to jump to it, or choose New task to open the composer.
- Press New task to open the composer. The description is a rich text field: type a hyphen for a bullet, 1. for a numbered list, [ ] for a checkbox, and / for commands. The formatting bar above it does the same by hand.
- Add subtasks in the composer before you save. Type a subtask, press Enter for the next one, and reorder them with the arrows. They are created with the task.
- Open the detail drawer to set priority, add comments, link subtasks, and attach files.
- Assign a recurrence rule so the task spawns a follow-up every time you mark it done.
FAQ
- Why does my parent task auto-close when I mark the last subtask done?
- Atlas propagates parent status forward. When every subtask reaches a "done" status, the parent closes automatically. The reverse never happens: marking a subtask back to todo never re-opens a closed parent. You can always reopen the parent manually.
- Can I block a task with multiple others?
- Yes. In the Dependencies section of a task, add as many tasks as you need that block it or that it blocks. The Links section relates a task to another with a relation kind that your workspace defines in Settings > Relation kinds. The API also accepts the dependency kinds duplicates and relates, which the screen does not offer.
- How do I see tasks I am blocked on right now?
- Open the task and read its Dependencies section: the tasks listed under Blocked by are holding it up. To see every task that has the Blocked status, open the Views page, group by status, and read the group for that status.
Automate this module