Task details

The task detail page is where you work a single task (some teams call it a ticket): set its status, fill in details, discuss it with teammates, and attach files. It's available to everyone who can see the task.

Who can use this

The task detail page is available to all roles. Anyone who can see a task can open it and work it. Some actions, such as creating or deleting a task, depend on your role's permissions.

Overview

Open a task from the Tasks list to reach its detail page. From here you can:

  • Edit the title, Description, Priority, Due date, Brand, Assignees, and Labels.
  • Change the task status (Todo, In Progress, In Review, Done, Canceled).
  • View linked orders and jump to an order.
  • Hold a discussion in the task's comment thread.
  • Add and remove attachments.

Each task shows a TASK-<number> pill at the top so you can reference it. Most edits save automatically as you make them.

Screenshot: The task detail page layout. (pending capture)

Change a task's status

The status control is the round glyph next to the task title. The status also drives whether the task counts as open or done.

  1. Open the task.
  2. Select the status glyph next to the title.
  3. Pick a status: Todo, In Progress, In Review, Done, or Canceled.

Choosing In Review starts a review request: you select one or more reviewers in Select Reviewers, and the task moves to "Review Requested". A reviewer can then Approve (which marks the task Done) or Reject (which returns it to In Progress). Anyone can Cancel review to clear the request.

Edit the title and description

The title and description sit at the top of the task. Both save automatically a moment after you stop typing.

  1. Select the task title to edit it inline, then type your changes.
  2. Select the Add Description... field and type the description.
  3. Click away when you're done; there's no separate Save button.

Set priority, due date, brand, and channel

These live in the Properties panel on the right (below the task summary on mobile). Each change saves automatically.

  • Priority — pick Low, Medium, High, or Urgent from the dropdown.
  • Due date — pick a date from the calendar, or clear it to remove the due date.
  • Brand — the brand (shown as a brand chip) the task belongs to. A brand must be set before you can start a discussion thread.
  • Channel — shown only for tasks created inside a brand channel. This is read-only.

The Properties panel also shows Created by and the Created date for reference.

Add or remove assignees

Assignees are the people responsible for the task. They appear as chips in the Assignees row of the Properties panel.

  1. In the Assignees row, select the + (Add assignee) button.
  2. In Select Assignees, choose one or more people, then confirm.
  3. To remove someone, select the remove control on their chip.

Note

The people you can assign depend on the task's brand. If the task is tied to a brand, the picker lists members with access to that brand.

Add or remove labels

Labels (also called tags) help you group and filter tasks. They appear in the Labels row of the Properties panel.

  1. In the Labels row, select the + (Add label) button.
  2. In Select Labels, pick existing labels, or choose + Create new tag to make a new one.
  3. If you're creating a label, enter a name in Create New Tag and select Create.
  4. To remove a label, select the remove control on its chip.

Work with linked orders

If a task has orders linked to it, they appear as order chips in the Orders row of the Properties panel. Orders are linked when the task is created or from an order's own screen.

  1. Select an order chip to open that order in the warehouse view.
  2. To unlink an order, select the remove control next to its chip.

For more on orders, see Orders.

Discuss a task in its thread

Each task can host a comment thread (a messaging conversation) so the discussion stays attached to the task instead of scattered across chats.

  1. On a task without a thread yet, find the Start a thread card and select Convert to thread.
  2. If the task has no brand yet, you'll be asked to pick one in Select Brand first — a brand is required to start a thread.
  3. Once the thread is created, type messages in the conversation to notify and reply to teammates.

On mobile, an existing thread shows as an Open thread tile; tap it to view the full conversation.

Tip

Prefer a quick aside that doesn't need a back-and-forth? See Notes. For general messaging, see Channels & threads.

Add or remove attachments

The Attachments section in the Properties panel holds files related to the task, such as photos, labels, or documents.

  1. Select Attachments to expand the section.
  2. Select the + (Add attachment) button to open the upload panel.
  3. Choose your file(s) to upload them; they appear in the attachments list.
  4. To remove a file, select delete on the attachment and confirm in the Delete Attachment dialog.

Warning

Deleting an attachment can't be undone. The file is removed from the task and from storage.

Common questions

How do I change a task status? Select the status glyph next to the task title and pick Todo, In Progress, In Review, Done, or Canceled. Choosing In Review prompts you to pick reviewers.

How do I add a comment to a task? Comments live in the task's thread. On a task without a thread, select Convert to thread on the Start a thread card (pick a brand if prompted), then type your message in the conversation.

How do I attach a file to a task? Expand the Attachments section in the Properties panel, select the + (Add attachment) button, and upload your file.

How do I link an order to a task? Linked orders appear in the Orders row and are added when the task is created or from an order's screen. On the task, select an order chip to open it, or use the remove control to unlink it.

Why can't I start a thread on this task? A thread needs a brand. Set the task's Brand in the Properties panel first, or pick one in Select Brand when prompted, then select Convert to thread.

Do my edits save automatically? Yes. Title, description, priority, due date, brand, assignees, and labels save automatically as you change them — there's no separate Save button.