Skip to main content

Filter builder

The visual builder is how an agent constructs a filter without writing any query syntax. Each field becomes a dropdown; each chosen value becomes a chip on the bar; the ticket list updates as the agent edits.

Search bar expanded across the inbox header with field dropdowns visible (Status, Priority, Assignee, Ticket Type) and three filter chips already applied below them

Adding a condition

The agent picks a field from the bar (for example, Status). A multi-select dropdown opens with all the values that field can take. The agent ticks one or more, and the selection appears as a chip on the bar. The ticket list refreshes immediately.

Multi-select dropdown opened from the Status field, with three values ticked (Open, In Progress, Pending)

Field types and operators

Field typeOperators
Dropdown / Status / CategoryIN, NOT IN (both multi-select)
User / Actor fields (assignee, reporter, watcher)IN, NOT IN, IS EMPTY, IS ME
Date fieldsIn the last N minutes / hours / days / weeks; more than N ago; between two dates; in a relative range like -3w 4d 12h 30m to +3w 4d 12h 30m
Text fieldsContains, Does not contain
Number fieldsEquals, Greater than, Less than, Between
Boolean / ToggleIs true, Is false

The operator picker appears inside each chip. Click the chip, change the operator, and the result updates without losing the chosen values.

Date range examples

NeedOperator
Tickets created in the last 2 hoursIn the last 2 hours
Tickets untouched for more than 3 daysMore than 3 days ago on Last updated
Tickets due between two specific datesBetween on Due date
Tickets with a -3w to +1w due-date windowRelative-range syntax on Due date

Date field expanded showing the four operator options (In the last N, More than N ago, Between, Relative range) with the relative-range option selected

Switching the operator

Every chip has a small operator dropdown next to the field name. Clicking it shows the operators that field supports - typically EQUAL TO, NOT EQUAL TO, IN, NOT IN, and IS EMPTY for dropdown and user fields. Pick a different operator and the chip updates without losing the chosen values.

To express "not this", switch the operator from EQUAL TO to NOT EQUAL TO (or from IN to NOT IN when you have multiple values).

Queue chip with the operator dropdown open, showing EQUAL TO (selected), IN, IS EMPTY, NOT EQUAL TO, NOT IN, with the value list (Finance ticked) below

Ticket-type-specific fields

The bar always shows the meta fields shared across all ticket types (Status, Priority, Category, Assignee, dates). Custom fields belong to specific ticket types and don't show up until the agent picks the ticket type.

To filter on a custom field:

  1. Open the Ticket Type dropdown and pick one (for example, Incident).
  2. A second row of field dropdowns appears with the custom fields for that ticket type.
  3. Add conditions the same way as for meta fields.

Ticket Type dropdown set to Incident, with a second row of custom-field dropdowns below the main bar

If the agent picks multiple ticket types, only the fields they share are offered for filtering.

Clearing the filter

The Clear all button at the right of the bar removes every chip and resets the list. Individual chips can be removed by clicking the small "x" inside the chip.