In this section · 7 articles

Share work through a queue and claim a task

Set up a queue for a team, choose who may claim from it, send tasks to it, and claim the next task as a member.

Applies to
Activities 3.1 and later
Who can do this
Team member, Administrator
Permission
feature.act.queue.claim
Where
Activities › Queues
On this page

Before you start

  • To set up a queue, you need Create Queue (feature.act.queue.create). To add members, you need Edit Queue (feature.act.queue.edit).
  • To claim from a queue, you need Claim Queue (feature.act.queue.claim), and you must be a member of that queue with May claim set to Yes. Super admins can claim from any queue.
  • A queue belongs to the workspace it's created in. Its members must be members of that workspace, and only tasks in that workspace can go into it.

Steps

Set up the queue (administrators)

  1. In the sidebar, open Activities › Queues.

  2. Select New Queue.

    The Create Queues form with Name "Support desk" and Code support-desk entered, an empty Description, Auto-claim off, Response target (minutes) blank and Active turned on.
  3. Enter a Name, for example "Support desk".

  4. Enter a Code, for example support-desk. Use lowercase letters, numbers, hyphens and underscores only. You can't change the code later.

  5. Optionally, add a Description.

  6. Leave Active turned on.

  7. Select Save.

Auto-claim is saved with the queue, but nothing acts on it: a task in the queue waits until a member claims it. Response target (minutes) isn't saved at all; the field is empty again when you reopen the queue.

Add members

  1. In the queue's row actions menu, select Members.

  2. Select New Member.

  3. In Member, choose the person.

  4. Set May claim to Yes if they should take work from the queue.

    The Create Members form for a queue with Member set to Ananya and the May claim switch turned on and highlighted, ready to save.
  5. Select Save.

If the person isn't in the queue's workspace, you see Add this person to the workspace before adding them to its queue.

Send a task to the queue

When you create a task, choose the queue in Queue, under Assignment, and leave Assigned to empty. See Create a task and set a reminder.

To move an existing task, you need Assign Task (feature.act.task.assign):

  1. On Activities › Tasks, open the task's row actions menu and select Assign.

  2. In Assignment, choose Queue.

  3. In Queue, choose the queue.

    The Assign dialog for one task with Assignment set to Queue and the Service jobs queue chosen in the highlighted Queue field, ready to assign.
  4. Select Assign.

Moving a task into a queue removes its assignee, so the next member who claims it gets it.

Claim a task (members)

  1. In the sidebar, open Activities › Tasks.

  2. Filter the list by Queue to see the queue's tasks.

  3. Select a task to open it.

  4. Select Claim.

    Task TSK-2026-000103, Move-in deep cleaning for Bhavana Rao, opened from Activities › Tasks, with the Claim button at the top highlighted.

The task is now assigned to you, and the main button changes to Complete. You can also claim straight from the list: open the task's row actions menu and select Claim.

If someone else claimed the task a moment before you, you see a message such as Priya claimed this first — you have been given the next task in the queue. The next task is the one with the highest priority, then the earliest due date.

What happens next

  • To hand a task back, open More actions in the task and select Release. You see Released back to the queue. The task loses its assignee, and any member can claim it. You need Release Queue (feature.act.queue.release), and you can only release a task you claimed yourself.

  • To remove someone from the queue, open Members and delete their row. Set May claim to No to keep them in the queue without letting them claim.