> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/screens-and-components/customize-a-screen/filtering-sorting-items.md).

# Filtering, Sorting, or Grouping Items

Filtering, sorting, and grouping are powerful tools that help users find and organize data more efficiently.

Filtering allows users to narrow down a list of items based on specific criteria.

Sorting helps users arrange items in a specific order.

Grouping helps users visually segregate the items based on a particular property.

{% hint style="info" %}
Grouping is only available on List Screens (View Items/Update Items).
{% endhint %}

{% hint style="info" %}
This is different from Notion databases filtering, sorting, or grouping because you can create multiple apps with different filters, sorts, or groups and provide it to different groups of users.
{% endhint %}

To filter or sort items, open the app builder. Go to the desired screen through the app preview. Click on "+ Add Filtering", "+ Add Sorting", "+ Add Grouping" to add filtering or sorting.

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FaTozlumRDmcm0bSeEmd8%2Ffilter-sort-1.png?alt=media&#x26;token=a5d7bab2-ad81-41f4-b725-12425cf35334" alt=""><figcaption></figcaption></figure>

### Filtering

To add filtering, click on **+ Add Filtering**. This adds a condition you can customize: a database column, an operator, and a **value type**.

Value types:

| Value type                                                   | What it compares against                                                          |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| **Fixed value**                                              | The exact value you pick                                                          |
| **Logged-in user**                                           | The signed-in Users row                                                           |
| **Logged-in user property**                                  | A property on that user (Pro+; turn **Allow logged-in user property filters** On) |
| **Current row** / **Current row property**                   | The parent record on a related list                                               |
| **Today** / **Now** / **Start of week** / **Start of month** | Clock tokens in the app timezone                                                  |
| **URL parameter**                                            | A query key on the published URL (for example `?store=north`)                     |

Click **+ Add group** to nest conditions with **and**, **or**, or **not** (up to 3 levels). **not** inverts one child condition or group.

{% hint style="info" %}
Example *Task Status* is equal to *Done* **and** *Due Date* is **Today**. Or share `/assets?store=north` after you set Store equals **URL parameter** → `store`.
{% endhint %}

{% hint style="warning" %}
Missing URL parameter If a **URL parameter** condition’s key is omitted or empty, that condition matches **no rows**. The list does not fall back to showing everything.
{% endhint %}

Maker walkthrough: [Filter lists with groups and dynamic values](https://docs.notionapps.com/how-to-guides/filter-lists-with-groups-and-dynamic-values).

### Sorting

To add sorting, click on "+ Add Sorting". This will add a default sort that you can customize further with the fields/columns to sort by. You can select the order, either ascending *(A → Z)* or descending *(Z → A)*, for each field.

{% hint style="info" %}
Keep in mind that during sorting, the first condition would be first used to sort and the second condition would be further used to sort grouped items inside the first sort result.
{% endhint %}

That's it! Now can you filter or sort your items to view them in a more efficient way.

{% hint style="info" %}
It's important to note that when filtering items, the items are sent filtered from our servers, and the users only have access to the data visible on the app.
{% endhint %}

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FlejMCM0uBi5B8h24GWGt%2Ffilter-sort-2.png?alt=media&#x26;token=dab7e50c-a411-43a7-8b5d-d2ac9af8d06c" alt=""><figcaption></figcaption></figure>

### Grouping

To add grouping, click on "+ Add Grouping". This will add a default group that you can customize further with the column/property to sort by. You can select the sort order, either ascending *(A → Z)* or descending *(Z → A)* for the grouping property.

{% hint style="info" %}
Currently only one property can be used to group items.
{% endhint %}

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FCAqM0qNao80W05FmMIpi%2FSCR-20250825-luhl.png?alt=media&#x26;token=1f238662-cdb7-498e-a8cd-7b4961ba3b5a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Sorting and grouping work well together. The grouping takes priority and inside the groups, the items are sorted based on your sorting order.
{% endhint %}
