> For the complete documentation index, see [llms.txt](https://bt-studio.gitbook.io/bestest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bt-studio.gitbook.io/bestest/test-management/catalog-features/filters.md).

# Filters

There are 5 filters available:

* Project search
* Quick search
* Simple
* BQL
* Visual - only available in Collection rules for now

## Project search

Press the search bar (or Ctrl / CMD + K) to open it, and search through any testing objects in that project by name or key.

<figure><img src="https://3532578673-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRekQAzTuU34yaMn8nFS%2Fuploads%2FT6BOnbIhu97oD8N3TvPu%2Fimage.png?alt=media&amp;token=1946b965-3b4c-4bff-b7ce-af63cdd26acb" alt=""><figcaption></figcaption></figure>

## Quick search

Type name or key into any search field to filter the table below.

<figure><img src="https://3532578673-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRekQAzTuU34yaMn8nFS%2Fuploads%2FHNWn0hbLBEYCBS5Nlfhl%2Fimage.png?alt=media&amp;token=465cba9e-b491-43be-b1e0-34b5f305fc3a" alt=""><figcaption></figcaption></figure>

## Simple filtering (beginner)

To access simple filtering, press ( 1 ) Filters, select ( 2 ) Basic, then use the ( 3 ) most frequent filters, or add a new criteria with a value from ( 4 ) Add filter. ( 5 ) Filters can be copied, cleared, closed.

<figure><img src="https://3532578673-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRekQAzTuU34yaMn8nFS%2Fuploads%2FIsjc7GCGHueHglqqmHt1%2Fimage.png?alt=media&amp;token=095bdaa2-43c9-4aae-9aca-374ce44a9e31" alt=""><figcaption></figcaption></figure>

## BQL Filtering (advanced)

BQL is simlar to Jira's JQL. You can set up fields + operator + value, and user AND/OR with combination of (). The UI autocompletes and syntax validates possibilities:

<figure><img src="https://3532578673-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRekQAzTuU34yaMn8nFS%2Fuploads%2FfwS9JX3WTbTn7BY3Wb4Q%2Fimage.png?alt=media&amp;token=f27d8bc6-dc07-461f-9e32-b9778ed0fa63" alt=""><figcaption></figcaption></figure>

Examples:

* **`status`**` ``IN ('DRAFT','ACTIVE') and`` `**`created_at`**` ``>= '2026-03-23'`
* **`folder`**` ``IN ("b897f029-f2a2-46bf-925f-73ffcb03c20f") and`` `**`created_by`**` ``= '798eaa36-58b9-49a1-add3-5d32a558712d'` - folder and user visually selected, but stored with an ID
* **`format`**` ``= 'TRADITIONAL' AND (`**`name`**` ``~ 'veri' OR`` `**`planned_time`**` ``>= 90)`

## Visual Filtering

This feature is designed to build Collections.&#x20;

<figure><img src="https://3532578673-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRekQAzTuU34yaMn8nFS%2Fuploads%2FtF1UXz786oWUrsKHoTML%2Fimage.png?alt=media&amp;token=775dd93c-5d1d-469d-a0c4-b297c7003e67" alt=""><figcaption></figcaption></figure>

**( 1 ) Folder rules**: Select a folder with its possible children

**( 2 ) Field Conditions**: Select the field, then select the expected values

**( 3 ) Groups**: combine multiple conditions with AND/OR to build complex rules