Filters turn a static dashboard into an interactive exploratory tool. Apache Superset offers several types of native filters, mature since version 4.x. This guide explains how to configure them, parameterize them, and avoid pitfalls in 2026.
1. Three types of native filters
| Type | Use case |
|---|---|
| Value | Filter by value (segment = "B2B") |
| Numerical Range | Slider between min and max |
| Time Range | Start date / end date |
| Time Column | Choice of time column (multi-fact) |
| Time Grain | Granularity (day, week, month) |
If you want an instance with pre-configured filters, TVL Managed Superset offers default templates.
2. Add a native filter
- Edit mode of the dashboard;
- Side panel Filters on the left → + Add/Edit Filters;
- Choose the type;
- Configure the dataset, column, default values;
- Apply to the dashboard charts.
3. Dependent filter (cascade)
Example: a Country filter that restricts the options of the City filter:
- Create the Country filter (Value, column
country); - Create the City filter (Value, column
city); - In the City filter config, check Filter is hierarchical and select Country as parent.
Now, selecting France reduces the proposed cities to France only.
4. Cross-filters
Cross-filters allow clicking on a chart to filter the others. Enable in the chart menu Cross-filter on click. Particularly useful on Bar Chart, Pie Chart, Heatmap.
5. URL filters
All filters can be pre-filled via the URL:
https://superset.example.com/dashboard/sales/?native_filters_key=<encoded>
URL generation via Share dashboard with current filters.
6. Dynamic default values
For a Time Range filter, defaulting to Last 30 days avoids the user scanning 5 years of data. Configuration in the filter's Default value.
This configuration is applied by default on TVL Managed Superset, which follows community best practices.
7. Scoped filters (limited to certain charts)
By default, a filter applies to all charts using the column. To restrict it:
- Edit filter → Scoping tab;
- Specific mode;
- Check only the relevant charts.
Useful for dashboards with several independent sections.
8. Common pitfalls
- Inactive filter: the filter column doesn't exist in the target chart;
- Default value too wide: very slow initial load;
- Cross-filter on dashboard with 30 charts: cascading explosion of queries;
- Value filter with 10,000 options: slow interface, prefer Numerical Range or autocomplete;
- Expired cookies: filters reset on each session.
9. Best practices
- Top 5 filters maximum per dashboard;
- Mandatory Time Range on temporal fact tables;
- Consistency: same labels as in SQL Lab;
- Test in multi-tenant: combine with RLS to not expose too many options.
10. Conclusion
Well-mastered, Superset's native filters transform passive dashboards into exploration tools. A few hours invested in understanding types and scoping suffice to produce much more useful dashboards.
Want the benefits of Apache Superset without the friction of installation and maintenance? Deploy your instance in 3 clicks with TVL Managed Superset, hosted in Europe (OVHcloud, Roubaix, France).
For more: cross-filtering, Jinja templating, first dashboard.