> For the complete documentation index, see [llms.txt](https://docs-v3.toucantoco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/filters/managing-filters/applying-filters.md).

# Applying Filters

Filters can be used in various layouts but you will not necessarily want it to be applied on all visualizations or won't be able to do so.

After creation, filters are applied automatically on all applicable visualizations.

{% hint style="warning" %}
**Warning**

HKPIs aren't filtered by default because they generally provide a higher-level view.
{% endhint %}

**To apply a filter:**

1. Edit the Home or a story
2. Hover the filter
3. Click on the "pen" icon
4. Click on the "stroked funnel" button on the wanted visualization

{% hint style="success" %}
The "stroked funnel" should change to a "funnel" and the visualization should now respond to the app filter value changes.
{% endhint %}

<div align="center" data-full-width="true"><figure><img src="/files/3EcqS79naq4pYv9JHp6D" alt="" width="184"><figcaption><p>Stroked funnel</p></figcaption></figure> <figure><img src="/files/Xkj1lEzOm1XOJCvc0tUZ" alt="" width="184"><figcaption><p>Funnel</p></figcaption></figure></div>

**To disapply a filter:**

1. Edit the Home or a story
2. Hover the filter
3. Click on the "pen" icon
4. Click on the "funnel" button on the wanted visualization

{% hint style="success" %}
The "funnel" should change to a "stroked funnel" and the visualization should no longer respond to the app filter value changes.
{% endhint %}

**When the filter is not applicable:**

* You should see a "warning" icon on the visualization

<figure><img src="/files/DlOBfCI7lSpQIS89oajY" alt=""><figcaption><p>Warnign icon</p></figcaption></figure>

### **Can I apply a filter on a different dataset than its source?**

Indeed, filters can be applied to visualizations only if they share common dimensions to filter on. You can use a filter on visualization that doesn't share the same dataset but shares the same dimension in it.

**Example**

* My filter is created from a dataset "ref\_country" which is a referential of countries and their geographical zones. Its values come from the column "country".

| country   | zone          |
| --------- | ------------- |
| USA       | North America |
| Canada    | North America |
| Argentina | South America |

* My visualization is created from a dataset "sales\_by\_country" that logs every purchase and the country from which it was bought.

| product   | country   | purchased\_at |
| --------- | --------- | ------------- |
| Product A | USA       | 01-01-2023    |
| Product A | Argentina | 01-01-2023    |
| Product B | Argentina | 01-01-2023    |

In that case, both "ref\_country" and "sales\_by\_country" share the dimension "country".

{% hint style="success" %}
You're able to filter your visualization with the filter.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/filters/managing-filters/applying-filters.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
