Add items

Pull sources into a queue and hand them to the right people

A queue’s Items tab is empty until you put something in it. This guide covers getting items into Support quality review, the running example from Create a queue, then filtering and assigning them once they’re there. Adding and assigning are both manager work: if you’re not a manager on the queue, you won’t see these controls at all.

Add items

Open Support quality review and switch to the Items tab. A queue with nothing in it shows No items in this queue with its own Add Items button. Once the queue has items, that button moves into the toolbar above the item table, next to the item filters covered below. Either way, click Add Items to open the picker: two ways to fill the queue, hand-pick specific items or set a filter and add everything it matches. Hand-pick when you already know the exact items you want; use filter mode when you want everything matching a rule, however many that turns out to be.

You can also push items from the source instead of pulling them from the queue. Select rows in a traces table, then Actions > Add to annotation queue opens a popover listing your queues: search for one, pick it, or create a new queue on the spot.

Hand-pick items

  1. Choose where the items come from: From Datasets, From Traces, From Spans, From Sessions, or From Simulation
  2. Use the checkbox column to select the specific rows you want
  3. Click Add to queue

Add by filter

  1. Choose a source the same way as hand-picking
  2. Set the filters that describe what you want, using the filter controls above that source’s table
  3. Instead of checking rows one by one, tick the header checkbox, then click Select all N matching your filter in the banner that appears above the table
  4. Click Add to queue. For traces, spans, sessions, and simulation, the queue resolves everything the filter matches on the server at that moment, not just what’s loaded on screen

Note

For a hand-picked selection, the picker splits a large add into multiple requests for you. Filter mode selections are capped at 10,000 items: past that, the whole add is rejected and you’re asked to narrow the filter first. Call the endpoint yourself instead of using the picker, and an enumerated list over 1,000 items is rejected outright with an HTTP 413. Full caps and gated behavior live on Queue settings & limits.

Two things worth knowing about what happens once items are added:

  • Duplicates are skipped, not errored. If a source is already in the queue, or shows up twice in what you’re adding, it’s dropped, and the confirmation names the count, for example “12 items added · 3 already in queue”
  • Assignment can happen automatically. If the queue has auto-assign turned on, incoming items get an assignee the moment they land. Otherwise they arrive unassigned, and someone has to assign them by hand

Note

The preview shown in the Items table is a snapshot captured the moment the item was added, not a live read of the source. Opening the item to annotate it always shows the current source.

Filter and find items

Above the item table sit the item filters:

  • Item status
  • Source
  • Review status, shown only when the queue has review turned on

There’s also a My Items toggle that narrows the table down to whatever’s assigned to you.

Assign and remove items

Select one or more rows and buttons join that same toolbar, scoped to your selection: Assign Selected and Remove Selected.

Assign Selected opens the Assign Selected Items dialog, and like adding items, it’s manager-only. Whoever you check becomes the full set of assignees on the selected items, replacing whatever was there before; check nobody and it clears the assignment instead. You can only check people who are already members of the queue: you can’t assign an item to someone who hasn’t been added yet.

Remove Selected takes the selected items out of the queue entirely, along with any annotations already submitted on them. There’s no undo: getting an item back means adding it again as a new item, starting from zero submissions.

Dive deeper

Was this page helpful?

Questions & Discussion