Filter Query Language

Expression Structure

Query structure consists of field, operator, and value:

For an expression like name==text, the structure is explained as follows:

Name	Description
`name`	Field ID or field name. Names with spaces can be wrapped in braces, e.g., `{single text}`
`==`	Comparison operator. Different field types support different operators, detailed below
`text`	Values with spaces are usually wrapped in double quotes, e.g., `name=="text 1"`

Note: field can only use characters other than system reserved characters, no spaces allowed. If spaces are needed, wrap with braces, e.g., {single text}

System reserved characters:

" ' ( ) ; , = ! ~ < > \n \t \r

Operators

Logical Operators

Logical Operator	Description
`;` or `and`	AND
`,` or `or`	OR

Compound queries combine multiple expressions to form complex query conditions.

Note: Only one type of logical operator can be used in a single query, they cannot be mixed. and and or cannot coexist, for example: ✅ Valid: single_text=="text 1";single_text=="text 2";single_text=="text 3" ❌ Invalid: single_text=="text 1";single_text=="text 2",single_text=="text 3"

Comparison Operators

Comparison Operator	Description
`==`	Equal to
`!=`	Not equal to
`>`	Greater than
`<`	Less than
`>=`	Greater than or equal to
`<=`	Less than or equal to
`=c=`	Contains
`=nc=`	Does not contain

Comparison Values

Usually can be strings/numbers, refer to the examples below:

Example	Type	Description
`text`	string	Text
`"simple text"`	string	Text with spaces, must be wrapped in double quotes
`123`	number	Number
`"123.45"`	number	Float, must be wrapped in double quotes, supports precision matching for number types
`true`,`1`	boolean	For checkbox field type cell values, these two can be true
`false`,`0`	boolean	For checkbox field type cell values, these two can be false
`null`, `NULL`	null	Check if cell value is empty, used with `==`, `!=` for judgment
`("option 1", "option 2")`	array	Array, can be used when cell is represented as array, used with `=c=`, `=nc=`, `==`, `!=`

Query Examples

Single Line Text Query

Supported operators: ==, !=, =c=, =nc=

Operator	Field Name	Query Example	Description
Equal to	`single_text`	`single_text=="simple text"`	Exact match for cells with specified content
Not equal to	`single_text`	`single_text!="simple text"`	Exact non-match for cells with specified content
Contains	`single_text`	`single_text=c="simple text"`	Cells containing specified content, value must be `string`
Does not contain	`single_text`	`single_text=nc="simple text"`	Cells not containing specified content, value must be `string`
Is empty	`single_text`	`single_text==null` or `single_text==NULL`	Cell content is empty
Is not empty	`single_text`	`single_text!=null` or `single_text!=NULL`	Cell content is not empty

Number Query

Supported operators: ==, !=, >, <, >=, <=

Operator	Field Name	Query Example	Description
Equal to	`number_field`	`number_field==123`	Exact match for cells with specified number
Not equal to	`number_field`	`number_field!=123`	Exact non-match for cells with specified number
Greater than	`number_field`	`number_field>123`	Cells with numbers greater than specified value
Less than	`number_field`	`number_field<123`	Cells with numbers less than specified value
Greater than or equal to	`number_field`	`number_field>=123`	Cells with numbers greater than or equal to specified value
Less than or equal to	`number_field`	`number_field<=123`	Cells with numbers less than or equal to specified value
Is empty	`number_field`	`number_field==null` or `number_field==NULL`	Cell content is empty
Is not empty	`number_field`	`number_field!=null` or `number_field!=NULL`	Cell content is not empty

Checkbox Query

Supported operators: == Supported values: true, false, 1, 0

Operator	Field Name	Query Example	Description
Equal to	`checkbox`	`checkbox==true` or `checkbox==1`	Query rows with checked cells
Equal to	`checkbox`	`checkbox==false` or `checkbox==0`	Query rows with unchecked cells

Single Select Query

Supported operators: ==, !=, =c=, =nc=

Operator	Field Name	Query Example	Description
Equal to	`single_select`	`single_select=="Option 1"`	Exact match for cells with specified option
Not equal to	`single_select`	`single_select!="Option 1"`	Exact non-match for cells with specified option
Contains	`single_select`	`single_select=c=("Option 1", "Option 2")`	Cells containing specified options
Does not contain	`single_select`	`single_select=nc=("Option 1", "Option 2")`	Cells not containing specified options
Is empty	`single_select`	`single_select==null` or `single_select==NULL`	Cell content is empty
Is not empty	`single_select`	`single_select!=null` or `single_select!=NULL`	Cell content is not empty

Multi Select Query

Supported operators: ==, !=, =c=, =nc=

Value type: array, e.g., ("Option 1", "Option 2")

Operator	Field Name	Query Example	Description
Equal to	`multi_select`	`multi_select==("Option 1", "Option 2")`	Exact match for cells with specified options
Not equal to	`multi_select`	`multi_select!=("Option 1", "Option 2")`	Exact non-match for cells with specified options
Contains	`multi_select`	`multi_select=c=("Option 1", "Option 2")`	Cells containing specified options
Does not contain	`multi_select`	`multi_select=nc=("Option 1", "Option 2")`	Cells not containing specified options
Is empty	`multi_select`	`multi_select==null` or `multi_select==NULL`	Cell content is empty
Is not empty	`multi_select`	`multi_select!=null` or `multi_select!=NULL`	Cell content is not empty

Date Query

Supported operators: ==, !=, >, <, >=, <=

Date comparison values can only be precise to year-month-day, not to hour-minute-second, for example:

✅ Valid: 2023-10-01 ❌ Invalid: 2023-10-01 12:00:00

Operator	Field Name	Query Example	Description
Equal to	`date`	`date=="2023-10-01"`	Match cell values within specified time
Not equal to	`date`	`date!="2023-10-01"`	Do not match cell values within specified time
Greater than	`date`	`date>"2023-10-01"`	Cells with dates greater than specified value
Less than	`date`	`date<"2023-10-01"`	Cells with dates less than specified value
Greater than or equal to	`date`	`date>="2023-10-01"`	Cells with dates greater than or equal to specified value
Less than or equal to	`date`	`date<="2023-10-01"`	Cells with dates less than or equal to specified value
Is empty	`date`	`date==null` or `date==NULL`	Cell content is empty
Is not empty	`date`	`date!=null` or `date!=NULL`	Cell content is not empty

Link Query

Supported operators: ==, !=, =c=, =nc= Value type: array, e.g., ("record1", "record2")

Operator	Field Name	Query Example	Description
Equal to	`link`	`link==("record1", "record2")`	Exact match for specified linked records
Not equal to	`link`	`link!=("record1", "record2")`	Exact non-match for specified linked records
Contains	`link`	`link=c=("record1", "record2")`	Contains specified linked records
Does not contain	`link`	`link=nc=("record1", "record2")`	Does not contain specified linked records
Is empty	`link`	`link==null` or `link==NULL`	Cell content is empty
Is not empty	`link`	`link!=null` or `link!=NULL`	Cell content is not empty

Recommend AI Automation Templates

Automated Currency Data Retrieval (JavaScript)

The Automated Currency Data Retrieval (JavaScript) template runs daily jobs to fetch exchange rates and write them into a table, giving you clean, structured historical exchange rate data without manual copy‑paste. Use it for financial data automation that feeds dashboards, alerts, and automated financial reporting, so finance teams, forex traders, accountants, and analysts always have up‑to‑date FX data. Over time, the template becomes a lightweight risk management tool by helping you monitor currency movements, spot trends, and support better investment and hedging decisions.

Customer development CRM

Streamline your product development process with this Customer Development CRM template. Manage customer personas, track interviews, collect qualitative feedback, prioritize backlog items, and plan feature enhancements to drive meaningful product improvement. Perfect for startups, product teams, UX researchers, and agile teams looking to focus on what customers need most.

Contractor Time Tracker

Contractor Time Tracker streamlines work data management by connecting tables, simplifying task, personnel, and client tracking, improving project progress, billing management, and project cost tracking. Effortlessly monitor work items, track employee performance, automate reminders, and ensure timely service completion for enhanced efficiency and accuracy in managing projects.

Employee Engagement Survey

The Employee Engagement Survey template is designed to help organizations efficiently measure employee engagement and satisfaction.This tool helps identify differences in employee experiences and supports data-driven decisions for goal setting and workplace improvement.

Diary reminder

Keep your thoughts organized with this Diary Reminder Template. Track daily writing, manage your diary entries, and receive automated nightly reminders. Generate weekly summary reports to review your life logging progress, enhance self-reflection, and maintain consistent journaling habits. Perfect for personal diary management, writing tracking, and improving productivity.

Batch generation of HeyGen AI videos

Quickly generate high-quality HeyGen AI videos with batch generation and automated video workflow. Customize characters and voices, streamline video creation, and save time.

Filter Query Language

Recommend AI Automation Templates

On this page