# Managing Team Tasks A team task carries everything the team needs to act on it: a status, a priority, who's assigned, a description, subtasks, attachments, and any custom fields your project uses. ![[team-list-epic-subtasks.png]] See also: [[Team Today]] for how tasks are organised on the day-planning board, including the filter panel and card details. ## Status Open a task's status chip to choose a status. The picker groups the project's statuses into Active, Backlog, and Closed where applicable. Inset rows and light separators keep the groups distinct; the selected status has a checkmark. A group label can be omitted when it would repeat its only status name. Use the arrow keys to move through the options, Enter to choose, and Escape to close the picker. ![[team-status-picker.png|280]] ## Priority Tasks have four priority levels, shown as a coloured flag: | Priority | Flag | |----------|------| | **Urgent** | Red | | **High** | Yellow | | **Normal** | Blue | | **Low** | Grey | - Set priority from the task panel, or **right-click a task** on the List view or Today board to change it quickly - The flag shows on cards and in the side panel so priority stays visible - **Bulk-set priority**: Select multiple tasks in List view and set priority for all of them at once from the multi-select action bar, the same way bulk status already works > [!tip] Right-click to triage > On both the List view and the Today board, right-click a card to set its priority without opening it. It makes triage fast when you're scanning the board. ## Assignees Assign one or more members to a task. Avatars appear on the card so ownership is obvious, and assignment is what surfaces a task under a person on the [[Team Today|Today board]]. An assignee's avatar also carries a **board badge** when the task is on that person's [[Team Board]] queue, and you can add or remove it from there, through the board glyph in the Assign menu, or by right-clicking the avatar. List view has an **On Board** column, shown by default, with the avatar stack of everyone whose board a task sits on. ## Subtasks Break a task into subtasks. Subtasks: - Nest directly under a top-level parent in List view; subtasks cannot contain further subtasks - Have their own status, priority, and assignees - Stay scoped to the same project as their parent - Can be **dragged to reorder** within their parent in List view - **Collapse subtasks**: A toggle in List view's **Display** menu hides subtask rows across every grouping. Expanding a row with its chevron takes priority over the toggle, and the setting is saved with the view > [!note] Same project only > A subtask belongs to the same project as its parent. You can't link a task under a parent from another project. > [!warning] Cascade-close on parent completion > Marking a parent task Done also closes its open subtasks. ## Converting between subtask and parent task A subtask can be converted into a standalone top-level task, and a task can be converted into a subtask of another task. A task doesn't need to be recreated from scratch just because it belongs at a different level. A subtask shows **Subtask of:** with a link to its parent above the title. To change its level, open the task's **...** menu, or right-click the row in Team List: - **Remove from parent** asks first, naming the subtask and its parent, then makes it a top-level task - **Move to another parent...** places the subtask under a different parent - **Convert to subtask of...** (top-level tasks) places the task under another task Each change shows where the task went, with **Undo**. ![[subtask-remove-confirm.png|476]] ## Moving tasks between projects Open a top-level task in the side panel or full-page view, open its task menu, and select **Move to project**. Search for the destination and select it. The available destinations depend on your access, and the task's subtasks move with it. You can also move a selection from List view. To move a subtask on its own, first convert it to a top-level task. ![[team-task-move-project.png|567]] ## Task Details panel ![[team-task-detail-panel.png|456]] Open a task's **Details** tab to see the work around it without leaving the description. Each kind of context sits in its own section card: - **Subtasks** show how many are done with a progress bar. Check off a subtask from its row, see completed subtasks inline, and add or import more from the row at the bottom - **Properties** start with Labels, then show only the fields that have a value or are pinned. Select **N empty fields** to reveal the rest. Text, number, date, and URL values edit right in the panel: press Enter or click away to save, or Escape to cancel - **Time** keeps the timer, elapsed time, and **Set plan** on one row, with a compact time log grouped below - **GitHub** shows the pull request summary, branches and commits in one list, and a ready-to-copy commit template through the [[GitHub Integration]] - **Attachments** have **Record**, **Upload**, and **List / Grid** controls in the header; the drop zone appears while the task has no attachments - **References** list the other tasks that link here in compact rows - **Activity** uses member pictures, relative times, and direct links so the history is easier to scan Subtasks, Properties, Time, GitHub, and Activity each collapse from their header, and Zaphiri remembers which sections you keep open. **Details** and **Comments** switch from a segmented control at the top of the panel. An unread badge appears on **Comments** while you are on **Details**, and each tab keeps its scroll position, so returning to a long task does not make you start over. ## Descriptions Task descriptions are rich text: headings, lists, checklists, tables, code blocks, and links. While writing, select text and choose **Improve** to get an [[AI Writing Assistant]] suggestion, or choose **Task** to turn the selection into a linked task. > [!tip] Paste from other tools > Rich formatting survives when you paste from ClickUp, Obsidian, Google Docs, or Word. Headings, lists, tables, and code blocks all come through cleanly, so you don't need to reformat after pasting. See [[Rich Text Editing]] for the full formatting toolbar: colour, inline images and link editing. A clock icon on any task opens [[Version History]], where you can compare versions with a diff and restore an earlier one. ClickUp links show their identifying text or destination URL, so you can see what you are opening. ![[team-clickup-readable-links.png|456]] ## Staying oriented while you scroll On a task with a long description, the title can scroll out of view quickly. Once it does, a compact sticky header takes its place, showing the status pill, title, priority flag and assignee avatar, so you know which task you're in. - Appears on every surface a task can open in: the full-page task view, the side panel, and tasks opened from notifications - A long title truncates with an ellipsis; hover to see the full title - When you edit a long title, the field wraps onto multiple lines so you can see the whole title as you type ## Attachments Add files and images to a task so context lives with the work. Files posted in [[Team Comments and Mentions|comments and replies]] also appear here, using the same attachment rather than a second copy. Choose **List** to scan filenames or **Grid** to browse thumbnails and file cards. Your browser remembers the view across tasks and reloads. Each entry includes the upload date in your timezone, its size, and the uploader. Hover the uploader avatar for their name. Widen the panel when you want more room for filenames or upload details. ![[team-attachment-list.png|431]] ![[team-attachment-grid.png|431]] Use **Show more** to reveal additional attachments and **Show fewer** to return to the shorter list. The disclosure stays as you switch between List and Grid. - **Drag into the description**: Drag an attachment from the Details sidebar, or from another task, straight into the description. Images and videos embed in place; other files become a link - **Copy Link on any attachment type**: every attachment, not just video, can be copied and pasted directly into a description, comment, or reply - **Copy Name and Rename** are also available on every attachment type from the same menu - **Colour-coded file icons** make it easy to spot the file type you're looking for at a glance, across task attachments, comment file chips, and Project Doc attachments - **Screen recordings skim like any other video**: click anywhere on the seek bar to jump to that point, and open the fullscreen viewer for a one-click playback speed selector (0.5x to 2x) - **10 MB limit** per file, enforced on upload - **500 MB storage quota** per project. Check current usage in the project's Storage tab under Settings > [!warning] Storage quota > When a project reaches its 500 MB quota, new uploads are blocked until files are removed. Owners can see per-project usage in project settings. > [!tip] Permission to download > Zaphiri asks before downloading a file. Files stay associated with the task they were attached to. ## Task IDs and links Every task has a short ID (for example, `TU-4287f447`) you can copy and share. Pasting a task link inside a Zaphiri description turns it into a titled link to that task; copied outside Zaphiri, it stays a plain URL. A task's **References** list shows everywhere else in Zaphiri that links back to it. Hover a reference to see a preview of that task without leaving the one you're reading. When you search for a task to reference or `[[` link, results show each task's status and assignees and list your most recently updated tasks first, so the task you're looking for is easier to spot. > [!tip] Copy what you need > Right-click a task in Team List, Team Board, Team Today, or a subtask row and hover **Copy** to copy its **Task name**, **Task URL**, or **Task ID**. Clicking the task ID chip in the task panel offers the same three options, which helps when referencing work in chat, commits, or other tools. ![[team-task-copy-menu.png]] ## Exporting a task Any task can be exported as Markdown, PDF, or HTML. When exporting, choose whether to include the task's subtasks in the export. ## Labels Tasks can have multiple coloured labels: tags for cross-cutting concerns like "blocked", "needs review", or "customer-facing" that don't belong in status or priority. Labels appear as pills on task rows and are filterable and groupable in List view. See [[Labels]] for the full reference. ## Custom fields Projects can define custom fields (text, number, date, URL, member, and select) to capture data specific to your team's workflow. Custom fields show on the task and can be added as columns in List view. See [[Custom Fields]] for the full reference, or [[Time Tracking and Settings]] to manage them in project settings. ## Resizing task details The right-hand Details panel can be **collapsed** to give the description and comments more room, or expanded when you need the full context. Zaphiri saves your preference for each person so the panel stays the way you left it. - **Drag to resize**: a resize handle lets you widen or narrow the panel instead of only collapsing it fully - **Works in preview too**: resizing is available whenever a task opens in a slide-over (from Team List, Team Today, Team Board or Notifications), not just the full-page task view - **Pick a reading width**: on the full-page task view, and in the task preview inside [[Team Notifications|Alerts]], a **Full width** control in the header lets the description stretch across the available space or stay in a comfortable reading column. Zaphiri remembers the choice on this browser and applies it to every team task you open the same way In an [[Team Notifications|Alerts]] preview of a top-level task, the reading-width control sits beside **Pin** in the header. Pin keeps the task at the top of the team list; it is separate from pinning a notification in Alerts. See [[Planning Team Work]] to add personal sessions or schedule a member's day from a task. ## Activity log Every task keeps an automatic log of changes: status updates, priority changes, assignments, GitHub activity, and more. The Details tab gives the latest activity a compact history, while the Comments tab places relevant activity alongside the conversation so you can see when and by whom a task moved forward. ## Live presence When multiple people are looking at the same task at the same time: - An **avatar stack** in the task header shows who else is viewing - A **typing indicator** ("X is typing...") appears in the header when someone is writing a comment - Active editors get a **pulsing ring** on their avatar - Changes from teammates appear in real time as they type in a task description or Project Doc, with **live cursors** showing exactly where each collaborator is working > [!tip] Built for simultaneous editing > Two or more people can edit the same task together. Live cursors and presence indicators help you see where teammates are working. ## Adding tasks When creating a task from the new task modal, you have two options for what happens after you save: - **Add and open**: creates the task and immediately opens it so you can fill in details - **Add and close** (Cmd+Enter / Ctrl+Enter): creates the task and dismisses the modal so you can keep adding quickly > [!success] Everything in one place > Status, priority, owners, description, files, and your own fields. A team task holds the full context so no one has to go hunting. --- **Next:** Pull team work into your day with [[Planning Team Work]].