-
+### Adding filters to dashboards
+**Temporary filters** (visible only to you):
+- Click `add filter` while viewing the dashboard
+- Or use cross-filtering by clicking on chart values
-Or in a dashboard:
+**Saved filters** (visible to everyone):
+- Enter edit mode by clicking `Edit Dashboard`
+- Click `add filter` and configure your filter
+- Click `Save` to apply the filter for all users
-
- 
-
+## Filter capabilities reference
+### Multiple filters
-### If you add multiple filters, you can choose to have `ALL` or `ANY` of the conditions match
+| Feature | How to use |
+|---------|-----------|
+| Add multiple filters | Click `+ Add filter` |
+| Combine with AND logic | Select `ALL` conditions from the dropdown |
+| Combine with OR logic | Select `ANY` conditions from the dropdown |
+| Add multiple values | Press `enter` between each value |
-To choose which option you want, just click on the drop-down menu on the top-left of the filters.
+### Nested filters
-
- 
-
-
-
-Selecting `ALL` conditions to match means you'd add an `AND` between your conditions in SQL. So, the example in the Explore view above would give us compiled SQL that looks like:
-
-```sql
-WHERE (
- (pages.source) IN ('lightdash_demo', 'lightdash_documentation')
- AND (pages.path) = '/20%crunchbase'
-```
+Create complex filter groups by converting a filter to a group:
-Selecting `ANY` conditions to match means you'd add an `OR` between your conditions in SQL. So, the example in the Explore view above would give us compiled SQL that looks like:
-
-```sql
-WHERE (
- (pages.source) IN ('lightdash_demo', 'lightdash_documentation')
- OR (pages.path) = '/20%crunchbase'
-```
-
-### If you want to include multiple values in your filter, just hit `enter` between each value entry in your list
+1. Click the options button on the right side of any filter
+2. Select `convert to group`
+3. Add additional filters within the group
- 
+ 
-
-The listed values are separated by an OR statement in the compiled SQL. E.g. the above would give us:
-
-```sql
-WHERE (
- (pages.source) = 'lightdash_demo'
- OR (pages.source) = 'lightdash_documentation'
-)
-```
-
-### To learn about the types of filters we have available, check out the filters reference doc.
-
-Check out our [filters reference doc here](/references/filters) to see a list of all available filters and their uses.
-
## Adding filters in the Explore view
There are a couple of ways that you can add filters in the Explore view.
From fcbed63f3b222cc1fcc6d28fa43f374c04da5e58 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 7 Oct 2025 19:39:18 +0000
Subject: [PATCH 2/5] Update guides/limiting-data-using-filters.mdx
---
guides/limiting-data-using-filters.mdx | 48 ++------------------------
1 file changed, 2 insertions(+), 46 deletions(-)
diff --git a/guides/limiting-data-using-filters.mdx b/guides/limiting-data-using-filters.mdx
index 026eda45..3ee5724f 100644
--- a/guides/limiting-data-using-filters.mdx
+++ b/guides/limiting-data-using-filters.mdx
@@ -56,53 +56,9 @@ Create complex filter groups by converting a filter to a group:
-## Adding filters in the Explore view
+### Filter types
-There are a couple of ways that you can add filters in the Explore view.
-
-### Adding a filter from within the `Filters` tab
-
-In the Explores view, you can add filters from within the `Filters` tab. Just click to open the toggle, then click `add filter`.
-
-
- 
-
-
-
-Select the field you would like to filter from the drop-down list, then select the filtering options.
-
-### Adding a filter from the sidebar
-
-It's easy to add filters directly from the list of fields in the sidebar. Just click on the `options` for a field, then click `add filter`.
-
-
- 
-
-
-
-### Adding a filter from the results table
-
-Once you have some results in your results table, you can add filters by clicking on the three-dot menu of the column you want to filter on, or by clicking on the value you want to filter by.
-
-
- 
-
-
-
-### Adding nested filters
-
-You can add nested filters by clicking on the options button on the right-hand side of the filter and then click on `convert to group`.
-
-
-
-
-
-
-Then, you can add a new filter to the nested filter by clicking `add filter`.
-
-
- 
-
+For a complete list of available filter operators and their uses, see the [filters reference documentation](/references/filters).
## Adding filters to your dashboard
From d928e490851ae8572db8a50705ba24c95a96e513 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 7 Oct 2025 19:40:57 +0000
Subject: [PATCH 3/5] Update guides/limiting-data-using-filters.mdx
---
guides/limiting-data-using-filters.mdx | 210 +++++++++----------------
1 file changed, 77 insertions(+), 133 deletions(-)
diff --git a/guides/limiting-data-using-filters.mdx b/guides/limiting-data-using-filters.mdx
index 3ee5724f..ab93b98a 100644
--- a/guides/limiting-data-using-filters.mdx
+++ b/guides/limiting-data-using-filters.mdx
@@ -61,192 +61,137 @@ Create complex filter groups by converting a filter to a group:
For a complete list of available filter operators and their uses, see the [filters reference documentation](/references/filters).
-## Adding filters to your dashboard
+## Dashboard filters
-There are a couple of ways that you can add filters to your Dashboards.
+### Temporary vs saved filters
-### Adding temporary filters to your dashboard
+| Filter type | Visibility | When to use |
+|------------|-----------|-------------|
+| **Temporary** | Only visible to you | Quick exploration without affecting others |
+| **Saved** | Visible to all dashboard viewers | Set default filters for the entire team |
-If you add a temporary filter to your dasboard, then only you will see the filters you've applied (you won't be changing the dashboard for everyone who comes to look at it). If you want to save the dashboard filters you're adding, then check out [adding saved filters to your dashboard](#adding-saved-filters-to-your-dashboard).
+
-
+1. Click `add filter` while viewing the dashboard
+2. Select the field and value to filter by
+3. Optionally adjust which tiles the filter applies to in the `Tiles` tab
-3. If you want, you can adjust which tiles the filter is applied to by clicking on the `Tiles` tab.
-
- 
-
+**Using cross-filtering:**
-You can remove the filter from a certain tile, or you can change which field the filter is applied to in a tile.
+Click on any value in a chart to filter the entire dashboard by that value.
- 
+ 
-4. And voilà! Your filters will pop up on the top of your dashboard.
+### Adding saved filters
+
+1. Click `Edit Dashboard` to enter edit mode
+2. Click `add filter` and select your field
+3. Configure the filter:
+ - **Leave value blank**: Dashboard viewers can set their own values
+ - **Set a default value**: Toggle 'Default value' and specify the value
+4. Adjust tile application in the `Tiles` tab if needed
+5. Click `Apply`, then `Save`
+
- 
+ 
-
+1. Edit your filter
+2. Check "Require value for dashboard to run"
+3. Save the dashboard
-3. Now, your filter will pop up on the top of your dashboard.
- 
+ 
+Until a value is set, the dashboard will remain locked.
-### Adding saved filters to your dashboard
-
-If you add a saved filter to your dashboard, then anyone that opens the dashboard will see the saved filters applied.
-
-To add saved filters, you just:
-
-1. Open up your dashboard.
-2. Make sure you're in `edit` mode (if you're not, you should see the option to click `Edit Dashboard`)
- 
+ 
-3. Click `add filter`, then specify the dimension or metric that you want to filter on.
-
-
-
+### Controlling filter scope
-4. You can leave the value blank, or you can specify a value that you want to filter by:
+Use the `Tiles` tab in the filter configuration to:
+- Remove the filter from specific tiles
+- Change which field the filter applies to in each tile
-If you leave the value blank, then no filter will be applied to the tiles in your dashboard. Importantly, this provides dashboard viewers the option to define a value in the filter, enabling them to tailor the results to their needs.
-
-
-
-
-If you want to specify a value, ensure you toggle 'Default value' so that you can apply a filter to the tiles in your dashboard.
-
- 
-
-
-5. If you want, you can adjust which tiles the filter is applied to by clicking on the `Tiles` tab.
+### SQL Runner chart filters
-You can remove the filter from a certain tile, or you can change which field the filter is applied to in a tile.
-
-
-
-
-
-6. Click `apply`, and your filters will pop up on the top of your dashboard.
-
- 
-
-
-7. Once you have all of the filters you want, just hit `save` to save your filter settings.
-
- 
-
+Dashboard filters work with SQL Runner charts in two ways:
-Now, whenever someone opens the dashboard, they'll see your saved filters applied!
-
- 
-
+**Mixed dashboards** (Explorer + SQL Runner charts):
+- Create filters normally by selecting a field
+- In the `Chart tiles` tab, apply the filter to SQL chart tiles and choose the column
-And if they want to drill-down into the data, they can always change the filters by clicking on the filter and adjusting the values.
-
- 
-
+**SQL-only dashboards**:
+- Choose a column from all available columns across charts
+- Provide a filter label for clarity
+- Select your operator and values
+- By default, applies to all columns with the same name
+### Filter precedence
-##### Dashboard filters override filters applied in a saved chart on the same field
+Dashboard filters override saved chart filters on the same field.
-For example, if I had a chart for Sales in Asia and I filtered to `country` **is** `China`, `India`, `Japan`. Then, on my dashboard I added a filter `country` **is** `India`. My saved chart's filter would be removed, and my new dashboard filter would be applied instead, so the tile in the dashboard would be filtered to: `country` **is** `India`.
+**Example**: A saved chart filtered to `country is China, India, Japan` with a dashboard filter of `country is India` will only show India data.
-Here's another example using a date filter: If my original saved chart was filtered to only include orders completed on or after April 3rd, 2024\. But, I add a date filter to my dashboard to include orders completed on or after August 1st, 2024, then the dashboard filter would override the saved chart filter and I'll end up with the chart filtered by orders completed on or after August 1st, 2022.
+**When exploring from a dashboard**:
+- `Explore from here` preserves dashboard filter overrides
+- `Edit` shows the original chart filters
-**How charts work in this context:**
+### Sharing with filter overrides
-* When you **Explore from here** from a dashboard, the chart will include the same filters you saw on the Dashboard version. Any filters overriden in the dahsboard will be overriden in the **Explore from here** view. Filters NOT overriden in the dashboad will be the same as they were in the original chart.
-* If you 'Edit' the chart instead of explore from here, you will see the original chart filters.
+Share dashboards with custom filter values from view mode:
+- Apply temporary filters or override saved filters
+- Copy the URL to share with filters applied
-Here's another example using a date filter: If my original saved chart was filtered to only include orders completed on or after April 3rd, 2022\. But, I add a date filter to my dashboard to include orders completed on or after August 1st, 2022, then the dashboard filter would be added to the saved chart filter and I'll end up with the chart filtered by orders completed on or after August 1st, 2022.
+**Override rules**:
+- **Temporary filters**: Can change field, value, operator, and tiles
+- **Saved filter overrides**: Can only change value and operator
+- Saving changes in edit mode removes overrides
-##### Dashboard filters autocomplete
+This behavior applies to scheduled deliveries and exports.
-When determining possible values for a dashboard filter, the system will take into account all relevant filters, including those applied to fields from joined tables.
+### Filter autocomplete
-Example with payments and orders models:
+Filter autocomplete considers all relevant filters from joined tables.
+**Example**:
```yaml
- name: customers
---
@@ -265,8 +210,7 @@ Example with payments and orders models:
sql_on: ${customers.customer_id} = ${orders.customer_id}
```
-Following this example:
-
-* when filtering on a field from the `payments` model, the system will consider the filters applied to fields from the `payments`, `orders` and `customers` models
-* when filtering on a field from the `orders` model, the system will consider the filters applied to fields from the `orders` and `customers` models
-* when filtering on a field from the `customers` model, the system will consider the filters applied to fields from the `customers` model
+When filtering:
+- `payments` fields: considers filters from payments, orders, and customers
+- `orders` fields: considers filters from orders and customers
+- `customers` fields: considers filters from customers only
From 7104182073eac03d5bd26dc576741ea6f3609a2f Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 7 Oct 2025 19:41:24 +0000
Subject: [PATCH 4/5] Update get-started/exploring-data/dashboards.mdx
---
get-started/exploring-data/dashboards.mdx | 74 +++--------------------
1 file changed, 7 insertions(+), 67 deletions(-)
diff --git a/get-started/exploring-data/dashboards.mdx b/get-started/exploring-data/dashboards.mdx
index 7fb5f5e0..31a9b517 100644
--- a/get-started/exploring-data/dashboards.mdx
+++ b/get-started/exploring-data/dashboards.mdx
@@ -160,16 +160,14 @@ You can also see all of the saved dashboards in your project by clicking on `Bro
## Add filters
-Now let's add some filters to your dashboard. First, start by editing your dashboard by clicking on the `Edit dashboard` button.
+Filters let you narrow down the data displayed across your dashboard charts. You can add filters while editing your dashboard or apply temporary filters while viewing.
-
- 
-
+To add a saved filter that all viewers will see:
-Click on the `Add filter` button to add a new filter to your dashboard by selecting a field and a value to filter by.
+1. Click `Edit dashboard`
+2. Click `Add filter`
+3. Select a field and optionally set a default value
+4. Click `Apply`, then `Save`
-
-
-Now that you've added a filter, you can see the filter applied to your dashboard.
-
-
- 
-
-
-Hit `Save` to save your dashboard with the new filter.
-
-
-### Leaving filters empty
-
-You might want to add an empty-value filter so that your dashboard viewers can choose their own value and explore the data based on their own criteria. Your dashboard viewers might also want to add their own filters to your dashboard.
-
-
-#### Adding an empty-value filter
-
-Just edit your filter and ensure that you don't provide a default value.
-
-
- 
-
-
-
-#### Marking a filter as required
-
-You can mark a filter as required for the dashboard to run. This means that the dashboard will not run unless a value is selected for the filter. Just edit your filter and check the "Require value for dashboard to run" checkbox.
-
-
- 
-
-
-Until viewers have set a value for the filter, the dashboard will not run.
-
-
- 
-
-
-To learn more about adding filters to your dashboards, check out our guide on [using filters](/guides/limiting-data-using-filters).
+For detailed information on filter types, temporary vs saved filters, required filters, and advanced filtering options, see the [using filters guide](/guides/limiting-data-using-filters).
## Add tabs
From c27a0c8506e64b893cf575152807153a3482be24 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 7 Oct 2025 20:08:06 +0000
Subject: [PATCH 5/5] Documentation edits made through Mintlify web editor
---
images/Screenshot2025-10-07at3.48.21PM.png | Bin 0 -> 38230 bytes
images/Screenshot2025-10-07at3.49.42PM.png | Bin 0 -> 78947 bytes
images/Screenshot2025-10-07at3.51.28PM.png | Bin 0 -> 92311 bytes
images/Screenshot2025-10-07at3.59.28PM.png | Bin 0 -> 37370 bytes
images/Screenshot2025-10-07at4.01.54PM.png | Bin 0 -> 27539 bytes
images/Screenshot2025-10-07at4.03.21PM.png | Bin 0 -> 40596 bytes
images/Screenshot2025-10-07at4.07.34PM.png | Bin 0 -> 29413 bytes
7 files changed, 0 insertions(+), 0 deletions(-)
create mode 100644 images/Screenshot2025-10-07at3.48.21PM.png
create mode 100644 images/Screenshot2025-10-07at3.49.42PM.png
create mode 100644 images/Screenshot2025-10-07at3.51.28PM.png
create mode 100644 images/Screenshot2025-10-07at3.59.28PM.png
create mode 100644 images/Screenshot2025-10-07at4.01.54PM.png
create mode 100644 images/Screenshot2025-10-07at4.03.21PM.png
create mode 100644 images/Screenshot2025-10-07at4.07.34PM.png
diff --git a/images/Screenshot2025-10-07at3.48.21PM.png b/images/Screenshot2025-10-07at3.48.21PM.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a05038b3b938bcb38f41cc9bcd1945339cdcbe5
GIT binary patch
literal 38230
zcmcG0Wl$bl*Cj3?I01sYySoGr7F>e{cXtc!1b5fq_TcUioZt}L-JR*==DpurGe73X
z)KJyc{q#Becz2(@*4l)Al9NDugYyOq3=C09QdAKP4EzK*WZ__dJN;P^n81(EW+Eb=
zq(nrBKH1wCn^_uxfl+<4is_KNdkJ3s(V2vG}P8Z|E{_4W;Mb9q*