# Filters

A **filter** is a tool to explore data through specific **dimensions**.

“*Dimensions*” is usually opposed to “*Facts*”. They are categories for data. For example “Country”, “Business Unit”, “Brand”, and “Year” are **dimensions.**

Viewers, using the App you created, will therefore be guided into their data analysis by interacting with the **filters** and getting answers to questions to get their job done, such as:

> “What are the sales figures for \[This Country] during \[This Year]?”

In order to help you design an App that will be easy to use by your end-users, we have defined different scopes & types of **filters.**

Filters are essential as they’re global and reusable throughout the entire App. Their location in Stories, Home, and Dashboard Builder is thought to explicitly highlight their importance: they are the **main point of view** that you want your end-users to discover.

Filters are a way for App Builders to think about the global message they want to communicate. They are also making it possible to address different **user** **populations** within the same App with strong **permissions rules** (cf. [Permissions](https://github.com/ToucanToco/doc-v3/blob/main/visualizations-and-layouts/creating-layouts/filters/broken-reference/README.md)).

Toucan wants you to build once and then deploy anywhere and to anyone.

<table data-view="cards"><thead><tr><th></th><th align="center"></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td align="center">Creating, reusing and editing Filters</td><td></td><td><a href="/pages/adsxVqf0hEhiezo7PBWU">/pages/adsxVqf0hEhiezo7PBWU</a></td></tr><tr><td></td><td align="center">Applying Filters</td><td></td><td><a href="/pages/SVSM0TKO3oxzFlVgg7xN">/pages/SVSM0TKO3oxzFlVgg7xN</a></td></tr><tr><td></td><td align="center">Removing and deleting Filters</td><td></td><td><a href="/pages/Y9skkSSbj0K3aB9PzZIs">/pages/Y9skkSSbj0K3aB9PzZIs</a></td></tr></tbody></table>

## Types of Filters <a href="#what-are-the-different-types-of-filters" id="what-are-the-different-types-of-filters"></a>

You’ll be able to let your user select a single value, a multiplicity of values, or a range of values.

### Single selection <a href="#single-selection" id="single-selection"></a>

* [Dropdown](/visualizations-and-layouts/apps/filters/type-of-filters/dropdown.md)
* [Buttons](/visualizations-and-layouts/apps/filters/type-of-filters/buttons.md)
* [Hierarchical](/visualizations-and-layouts/apps/filters/type-of-filters/hierarchical.md)

### Multiple selections <a href="#multiple-selections" id="multiple-selections"></a>

* [Checkboxes](/visualizations-and-layouts/apps/filters/type-of-filters/checkboxes.md)
* [Buttons](/visualizations-and-layouts/apps/filters/type-of-filters/buttons.md)

### Range selections <a href="#range-selections" id="range-selections"></a>

* [Date Range](/visualizations-and-layouts/apps/filters/type-of-filters/date-range.md)


---

# 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-v3.toucantoco.com/visualizations-and-layouts/apps/filters.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.
