Filters ​

Filters allow you to conditionally select Items from a Collection. Use-cases include customizing Item search results, restricting Item access permissions for specific Users or Roles, building dashboard analytics with the Insights module, and more.

How it Works ​

A basic filter is composed of 3 parts: A Field from the Collection being Filtered, a logical Operator, and some specified Value to filter for within each Item's Field.

2. Click filter_list or "Add Filter".
3. Select the Field to filter by.
4. Select the Operator as desired.
5. Define the Value to filter for.

From here, you can set multiple Filters at once, filter by Fields in related Collections, set Values with Dynamic Variables, as well as apply AND/OR Groups.

AND/OR Groups ​

AND Groups give the option to filter for Items that meet all of several criteria. On the other hand, OR Groups filter for Items that meet any one of several criteria.

1. Click "Add Filter".
2. Click "And/OR Group" at the very top of the dropdown menu.
3. Click the AND/OR text to toggle:
   • AND – Selects Items that meet every single criteria.
   • OR – Selects Items that meet one of several criteria.
4. Click "Add Filter" again.
5. Configure the Field, Operator, and Value as desired.
6. Click and hold drag_indicator to drag a Filter and nest it under an AND/OR Group.

Dynamic Variables ​

The following video shows how to filter for Blog posts written within the past 60 days.

The following Dynamic Variables are built into Directus to make Filtering easier: $CURRENT_USER, $CURRENT_ROLE, $CURRENT_ROLES, $CURRENT_POLICIES, $NOW and $NOW(<adjustment>). For more information, please see the Dynamic Variables section in Filter Rules.

Filtering by Related Collections ​

You may need to run filters on one Collection based on information in another related Collection. Here are a few examples of when that might happen:

• Book authors that also wrote screenplays (filters authors, uses screenplays).
• Products with a 5 star customer review (filters products, uses reviews).
• Accounts with active user login within the last 12 months (filters accounts, uses logins).

This can span across any number of relationally linked Collections. For example, you could filter for customers that bought rock songs, where the customers and genres Collections are linked by customers -> invoices -> invoice-items -> tracks -> genres.

You will notice a chevron_right icon beside relational Fields. When you click on any Alias Field, all the Fields for that associated Collection pop down. If you select one of these Fields, you can run Filters on the current Collection by Field values in a related Collection.

Here are step-by-step instructions on how to filter by Fields in other Collections:

1. Click "Add Filter".
2. Click the desired relational Field. This will pop down and display the related Collection Fields.
3. Select a Field from this related Collection.
4. Set the Operator and Value as desired.

Unfilterable Fields ​

Not all Fields can be filtered. As seen above in Filtering by Related Collections, Alias Fields cannot be filtered; they instead provide a dropdown menu to access Fields from a related Collection. Additionally, the "Presentation" and "Group" Fields cannot be filtered at all and will not appear as an option in Filters.

Extensibility Options ​

Directus Core is completely open-source, modular and extensible. Extensions allow you to expand or modify any part of Directus to fit your needs. Here are some great resources to get started down that track.

• Extensions > Introduction
• Extensions > Creating Extensions
• Contributing > Introduction
• Contributing > Codebase Overview

More Help ​

Looking for technical support for your non-enterprise project? Chat with thousands of engineers within our growing Community on Discord