Skip to content

Query syntax

What you can type in a query bar, in Data models and on Kanban boards. A query is a list of conditions written field:value; a record must match all of them.

Conditions

You writeMatchesWorks on
status:openthe field equals the value (the usual match for the field's type)any field
status:open,blockedany of the listed valuesany field
name:="Acme Inc"exactly this text, ignoring case; quote any value that contains spacestext
priority:>3greater than; also >=, <, <=numbers, dates (after / before)
name:~acmecontainstext
name:!~testdoesn't containtext
name:^acmestarts withtext
name:$incends withtext
tags:&urgent,customerhas all of the listed valuesmulti-select
due:2026-10-01..2026-10-31between, inclusivenumbers, dates
assignee:emptythe field has no valueany field
assignee:presentthe field has a valueany field
done:true / done:falsechecked / uncheckedcheckbox
client.country:FRa field of a linked record (one level)relation fields

Combining conditions

You writeMeaning
status:open priority:>3both (a space means AND)
status:open OR status:blockedeither
(status:open OR status:blocked) assignee:@megroup with parentheses
-assignee:presentNOT: put - before any condition
-status:done,cancellednone of the listed values

Variables

Variables are filled in when the query runs, so a saved view stays correct for whoever opens it, whenever.

VariableMeans
@meyou (use on people fields: assignee:@me)
@nowthis moment
@today, @yesterday, @tomorrowthat day
@startOfWeek, @endOfWeekthis week's bounds
@startOfMonth, @endOfMonththis month's bounds
@startOfYear, @endOfYearthis year's bounds

Example: due:@startOfWeek..@endOfWeek assignee:@me lists what you have due this week. Dates are in UTC.

Errors

An unknown field name, or a condition that doesn't suit the field's type (such as > on a text field), shows Invalid query: with the reason.