# Add filters to a dashboard (/core/build/dashboards-and-layouts/how-to/add-filters-to-a-dashboard)







<CalloutContainer type="info">
  <CalloutDescription>
    **Target Audience**: Non technical users
  </CalloutDescription>
</CalloutContainer>

### Goal [#goal]

Implement filter components and map them to specific database columns across one or more dashboard charts.

***

### Prerequisites [#prerequisites]

* An [existing dashboard](/core/build/dashboards-and-layouts/how-to/create-a-dashboard-with-ai) with at least one chart.
* [Charts added to your dashboard](/core/build/charts/how-to/create-a-chart) that you want to filter.
* Identified data columns in the connected database to serve as filter criteria (e.g., `date`, `region`, `status`).

***

### Steps [#steps]

#### 1. Open the Dashboard Editor [#1-open-the-dashboard-editor]

* Navigate to the **Library** tab from the Toucan.ai home page.
* Select the target dashboard to enter the editing interface.

#### 2. Initialize a Filter Component [#2-initialize-a-filter-component]

* Click the **Add Filte**r button in the top-right corner.
* Select a filter type based on the data requirement:
  * **Dropdown**: Restricts selection to a single value.
  * **Multi-select**: Enables selection of multiple values from a list.
  * **Date Range**: Enables selection of a start and end point for date data.

<img alt="Filter Types" src="__img0" />

#### 3. Configure Filter Properties [#3-configure-filter-properties]

* Input a factual **Name** for the filter (e.g., "Contract Type").
* This name serves as the label visible to end-users in the dashboard.

#### 4. Link Filter to Charts [#4-link-filter-to-charts]

* Click the **Link Filter** icon (link symbol) located next to the filter name.
* Click on the specific charts that must respond to this filter.
* For each linked chart, select the database column that matches the filter criteria (e.g., map the "Contract Type" filter to the `contract_type` column).
* Repeat this mapping for every chart in the dashboard that shares the relevant data.

<img alt="Apply Filter" src="__img1" />

#### 5. Save and Validate [#5-save-and-validate]

* Click the **Close** button to finalize the filter configuration.
* Select different values in the new filter to verify that the linked charts update correctly.

***

### Conclusion [#conclusion]

The dashboard now includes interactive filters synchronized across the selected charts. Users can now refine the visualized data based on the defined dimensions.

**Suggested Next Steps**: [How-to: Embed a dashboard](/core/embed/embedding-overview/how-to/embed-a-dashboard)