# Creating, reusing and editing Filters

Creating a filter in Toucan is important to make a global and interactive point of view for your end-users. As they're global, once you create one, you can reuse it across different layouts.

**To create a filter**:

1. Edit the Home or a Story
2. Click on "Add a filter"
3. Click on "Create a filter" in the dropdown
4. Select the source dataset in the dataset selection modal
5. (optional) Choose a [filter type](/visualizations-and-layouts/apps/filters/type-of-filters.md)
6. Select a column in the source dataset in the configuration panel
7. Set a name for your filter
8. Click on "Create"

{% hint style="success" %}
Your filter should replace the placeholder you clicked in step 2.
{% endhint %}

{% hint style="warning" %}
Once your filter is created, you can't edit the column or the dataset used by the filter.
{% endhint %}

**To reuse an existing filter**:

1. Edit the Home or a Story
2. Click on "Add a filter"
3. Select the filter you want to use

{% hint style="success" %}
Your filter should replace the placeholder you clicked in step 2.
{% endhint %}

**To edit a filter**:

1. Edit the Home or a Story
2. Hover the filter
3. Click on the "pen" icon

{% hint style="success" %}
The filter configuration panel should open on the left.
{% endhint %}

{% hint style="info" %}
You can also change the column and dataset of a filter:

If you change the dataset of a filter, you may find yourself in one of three situations:

* filtering in the layout (filtering is automatically applied)
* filtering from a dataset (If the name of the column changes completely, you will have to change it. If the column exists, there will be no problem).
* filtering from a dataset with an additional value (the additional value is not currently processed)
  {% endhint %}

**To move a filter**:

You're able to reorder your filters pinned into a layout.

1. Edit the Home or a Story
2. Hover the filter
3. Click and hold the "drag\&drop" icon
4. Move the app filter where you want it to be

{% hint style="success" %}
The filter has been moved.
{% endhint %}

Here's a quick overview of how to add existing filters of various types to a story.

{% embed url="<https://youtu.be/ozhpc__iJXk>" %}
Adding different types of filter on a story
{% endembed %}


---

# 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/managing-filters/creating-reusing-and-editing-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.