> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Filter interactivity

> Configure cross-filtering and faceted filters so viewers can interact with dashboards by clicking charts and linking related filters.

export const DisabledFilterIcon = ({label}) => {
  return <span>
      <svg class="icon-position" width="1em" height="1em" xmlns="http://www.w3.org/2000/svg" stroke-width="2" viewBox="0 0 24 24" fill="currentColor"><path d="M6.92893 0.514648L21.0711 14.6568L19.6569 16.071L15.834 12.2486L15 13.4999V21.9999H9V13.4999L4 5.99993H3V3.99993L7.585 3.99965L5.51472 1.92886L6.92893 0.514648ZM9.585 5.99965L6.4037 5.99993L11 12.8944V19.9999H13V12.8944L14.392 10.8066L9.585 5.99965ZM21 3.99993V5.99993H20L18.085 8.87193L16.643 7.42893L17.5963 5.99993H15.213L13.213 3.99993H21Z"></path></svg>
    </span>;
};

In addition to the standard [dashboard filter](/visualize-present/dashboards/filters) controls, Omni offers two ways to make filtering more interactive:

* **Cross-filtering** — viewers click chart elements to filter the rest of the dashboard
* **Faceted filters** — one filter narrows the options shown in another, for example a state filter narrowing a city filter to cities in that state

Both are off by default and configured per dashboard in the [dashboard's settings](/visualize-present/dashboards/settings).

## Requirements

Creating and modifying filters requires **Editor**, **Manager**, or **Owner** permissions on the document.

## Cross-filtering

Cross-filtering lets viewers filter a dashboard by clicking elements in a chart. When a viewer clicks a data point, bar, or other element, they get the option to create a filter that applies across all compatible tiles.

Cross-filters apply to any tile with a joinable relationship to the filtered field through the [semantic model](/modeling). When a cross-filter is active, tiles that it can't filter will have a <Badge color="blue" icon={<DisabledFilterIcon />} /> badge, which you can hover over to see why.

### Supported visualization types

Cross-filtering works with:

* Vega-Lite charts (bar, line, area, scatter, heatmap)
* Pie and donut charts
* Maps (choropleth and point)
* Data tables
* Sankey

### Enabling cross-filtering

Cross-filtering is off by default. Enable it in the [dashboard's settings](/visualize-present/dashboards/settings).

### Creating a cross-filter

There are several ways to create a cross-filter from a chart:

* **Click-to-filter** — click any chart element to filter the dashboard by that value
* **Brush selection** — on charts with a continuous axis (time series or numeric), click and drag to select a range. This creates a range filter on all compatible tiles.
* **Multi-select** — after creating a cross-filter on a discrete field, `Cmd + Click` (Mac) or `Ctrl + Click` (Windows) to add more values

### Removing a cross-filter

When a cross-filter is active, a chip appears below the dashboard filters. Click the <Icon icon="xmark" iconType="solid" className="icons" /> on the chip to remove it.

### Seeing which tiles a cross-filter affects

New cross-filters focus automatically. Click a cross-filter chip to focus it, or click it again to clear the focus.

While a cross-filter is focused, tiles it can't filter will have a <Badge color="blue" icon={<DisabledFilterIcon />} /> badge. Hover over the badge to see why the tile can't be linked - for example, a SQL tile without a templated filter for that field.

### Limitations

* Cross-filters don't apply to null values
* Custom SQL queries don't automatically support cross-filtering unless they use [dynamic filtering](/analyze-explore/sql#custom-sql-filters)
* **Linked tiles** — tiles sourced from a separate workbook tab have their own query and can't receive cross-filters
* **Raw SQL tiles** — SQL-mode tiles can only be cross-filtered if they include a [templated filter](/visualize-present/dynamic-content) (`{{# fieldName }}`) for the relevant field
* Downloads do not apply cross-filter selections

## Faceted filters

Faceted filters automatically link two filters so that one narrows the values of another. For example, a `state` filter limits the `city` filter's options to only cities in the selected state. Faceted filters also work alongside [access filters](/modeling/develop/data-access-control).

### Enabling faceted filters

Faceted filters are off by default. Enable them in the [dashboard's settings](/visualize-present/dashboards/settings).

## Next steps

* [Working with dashboard filters](/visualize-present/dashboards/filters) — create filters, set defaults, and connect them to tiles
* [Filter display options](/visualize-present/dashboards/filter-display-options) — choose how filters are displayed to viewers
* [Dashboard settings](/visualize-present/dashboards/settings) — toggle cross-filtering, faceted filters, and other dashboard behaviors


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.