# Filters - Checkly Docs > Filter the Monitors, Heartbeats, Test sessions and Error Groups lists, join filters with "and" or "or", and group them. Source: https://www.checklyhq.com/docs/platform/filters/ --- - Add a filter - Fields - Pick the time range - Join filters - Group filters - Use the keyboard - Save and share filters Platform # Filters Filter the Monitors, Heartbeats, Test sessions and Error Groups lists, join filters with “and” or “or”, and group them. On Monitors, Heartbeats, Test sessions and Error Groups, you filter the list in the filter field above it. Each filter is a block with a field, an operator and a value, such as **status is failing**. Filters join with **and** or **or**. Groups let you mix both. ## ​ Add a filter Click the filter field to list every field you can filter on. Each field shows a short description. Pick a field, or type the start of its name and press Enter. Typing the name followed by a colon, such as `name:`, does the same. A text field such as **Name** then waits for its value. Type it and press Enter. A field with a fixed set of values, such as **Status** or **Tags**, starts with one of its values. Click the value to pick others. With the keyboard, move to the value and start typing. Fields like **Tags** take several values. The filter then matches any of them. The block shows how many it holds, such as **3 tags**. Long lists, such as your tags, have a search at the top of the picker. Text that doesn’t start a field name searches by name when you press Enter. On Test sessions, it searches the project name. On Error Groups, it searches the error message. ## ​ Fields Screen Fields Monitors Name, Group, URL, Logical ID, Status, Check type, Tags, Project and Traces Heartbeats Name, Ping URL, Status, Tags, Period, Grace and Availability Test sessions Project, Environment, Branch, Commit, User, Has user, Status, Provider, Duration, Check, Check type, Tags and File Error Groups Message, Project, Environment, Check type, Playwright project and Count - **Text fields** such as **Name**, **Group** and **URL** match when the text holds every word you type. The words can be in any order. - On Monitors, **Tags** matches the tags of a check and the tags of its group. - **Project** shows when the account has checks deployed with the [Checkly CLI](https://www.checklyhq.com/docs/cli/overview). **Traces** shows when the account [imports traces](https://www.checklyhq.com/docs/resolve/traces/import/overview). - **Period**, **Grace** and **Duration** compare durations such as `30s`, `5m`, `1h` or `1d`. **Availability** compares the percentage for the selected time range. These four take `>`, `>=`, ` The date picker left of the filter field sets the time range. Click it and pick a preset, such as **Last 24 hours**. To pick days on a calendar, open **Custom**. Set the start and end times, then click **Apply**. A custom range shows as its days, such as **21-22 Oct**. The time range always applies on top of the filters. A view saves it with the filters. ## ​ Join filters Filters join with **and** by default. The list then shows what matches every filter. Click the word between two filters to switch it to **or**. The list then shows what matches any filter. The switch applies to every join at that level. To join only the next filter with **or**, type `or` and a space. The **or** shows at the end of the field. The next filter you add joins with it. For example, with **status is failing and name contains api** in the field, type `or url` and press Enter. Then type `health` and press Enter. The field now reads **status is failing and (name contains api or url contains health)**. The new filter is grouped with the filter right before it. The other joins don’t change. Typing `and` works the same way. Without a typed join, a new filter joins with **and**. Press Backspace in the empty field to remove a typed join. ## ​ Group filters A group holds filters joined by its own **and** or **or**. Click the word inside a group to switch it. To build a group from the keyboard, type `(` in the filter field. An empty group opens with the cursor inside it. The filters you add next go into it. Type `or` before a filter to join the group’s filters with **or**. Type `)` to close the group and go back to the top level. Leaving the field or pressing Escape also closes it. For example, to find checks with “checkout” in their name or in their URL: - Type `(`. - Type `name` and press Enter. Type `checkout` and press Enter. - Type `or url` and press Enter. Type `checkout` and press Enter. - Type `)`. The field then holds **(name contains checkout or url contains checkout)**. With the mouse: - **Make a group:** drop a filter onto another one. - **Move filters:** drag a filter to reorder it, or to move it into or out of a group. - **Move a group:** drag it by its handle. A group can’t hold another group. More examples: - On Heartbeats, **status is failing and (period > 1h or availability Every part of a filter is reachable from the keyboard. Key What it does Tab, Shift+Tab, Left, Right Moves between the parts of the filters and the joining words Typing on a value Changes the value, or searches the picker of a field with many values Enter, Space Opens the picker of the focused part, or switches the focused joining word Backspace, Delete Removes the focused filter, or a filter whose value you are typing while it is empty Alt+Left, Alt+Right Moves the focused filter left or right. It can move into and out of groups. In the empty filter field, Backspace removes a typed join first, then the last filter. ## ​ Save and share filters The page URL holds every filter and its groups. Copy it to send the same list to a teammate. On Monitors, Heartbeats and Test sessions, you can save filters you use often as a [view](https://www.checklyhq.com/docs/platform/views). Was this page helpful? [Suggest edits](https://github.com/checkly/docs/edit/main/platform/filters.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/platform/filters) [Groups Previous](https://www.checklyhq.com/docs/platform/groups)[Views Next](https://www.checklyhq.com/docs/platform/views) [x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly) [Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)