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 — which of the brand's channels the task lives in. Tasks created outside a channel sit in the brand's General chat. You can move a task to a different channel — see Move a task to another channel.

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

Move a task to another channel

If a task ended up in the wrong channel, you can move it to another channel on the same brand — for example from General into a dedicated #returns channel.

  1. Open the task and find the Channel row in the Properties panel.
  2. Select the move control to open the Move task dialog.
  3. Pick General or any of the brand's channels. The task's current home is marked Current.
  4. Select Move.

Moving a task keeps everything attached to it: its own discussion thread, notes, attachments, followers, and assignees all come with it. Messages already sent in the old channel stay where they are — they belong to that conversation, not to the task. Both channels get a short note about the move, and the destination channel gets a fresh task card so the task is easy to find in its new home.

Note

A task can only move between channels within its own brand. To change the brand, use the Brand row in the Properties panel instead. A few destinations aren't available: you can't move a task into an archived channel or into a brand's onboarding channel. Moving a task out of the onboarding channel clears the onboarding milestone it was grouped under.

Moving a task needs the same permission as editing one. If you can't edit tasks, the move control won't be available.

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.

How do I move a task to a different channel? Open the task, find the Channel row in the Properties panel, and select the move control. Pick General or another of the brand's channels in the Move task dialog, then select Move. The task's thread, notes, and attachments come with it; messages already sent in the old channel stay there.

Why can't I move this task into a particular channel? Tasks can only move between channels on their own brand, and archived channels and the onboarding channel aren't valid destinations. To move a task to a different brand, change the Brand in the Properties panel instead.

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.