> 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/creating-reusing-and-editing-filters.md).

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