# In-app Filtering

In-app filtering allows your app users to filter data within your app based on specific criteria. You can add different filter columns to any list.

Filter columns are database columns on whose values your users can filter data in the app. NotionApps detects the unique values when a column is selected and uses them as filters. For example, when the “Order Status” column is selected as a filter column, “Pending” and “Delivered” will be shown as filters if they are the unique values in the column.

{% hint style="info" %}
This feature is available on

* List Screens (View Items/Update Items)&#x20;
* List component
* Page Selector component
  {% endhint %}

Here's a step-by-step guide.

1. Go to the list screen, i.e. List (View Items), List (Update Items) where you want to enable in-app filtering.

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FXT3swTVKNWJq5qg2YdIK%2Fin-app-filter-1.png?alt=media&#x26;token=30b3cd26-7521-49ea-b6aa-9d7f547a5fca" alt=""><figcaption></figcaption></figure>

2. Click on +Add Filter Column and select the column based on whose values you'd want to filter out the items.

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FUNcYSWvqEK2l5zyeZ75a%2Fin-app-filter-2.png?alt=media&#x26;token=026abaad-5eee-460c-8540-d263f99461cc" alt=""><figcaption></figcaption></figure>

That's it! Now you can click on the filter icon on your screen to filter out items/pages matching the column values.

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FKDmcuRe0hWjutKLR2CaS%2Fin-app-filter-3.png?alt=media&#x26;token=f5d47e57-410c-40a7-ac9a-261d8cec5746" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FAZSuPSlpQLXzR7bU1H5X%2Fin-app-filter-4.png?alt=media&#x26;token=d01dca29-1f2a-411f-b5b5-cf3d7e1671c7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FT5zw2FslrHqVYXdjCEEg%2Fin-app-filter-5.png?alt=media&#x26;token=0726cc9a-35b5-4356-97f2-9a8b546b7e22" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can also add multiple filter columns if you'd want to combine the result of different filters.
{% endhint %}

<figure><img src="https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2FSwkcqCp47Wz04tfK9e3a%2Fin-app-filter-6.png?alt=media&#x26;token=14d27126-bd2f-4dee-a321-7c7d09228006" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.notionapps.com/customize-app/customize-a-screen/in-app-filtering.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
