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

# Cross Dashboard Drill Down

> Enable cross-dashboard drill-down to filter all metrics on a dashboard based on a drilled dimension, providing interconnected analysis across your entire dashboard.

## What is Cross Dashboard Drill Down?

Regular drill-down only affects the single metric you click on. **Cross Dashboard Drill Down** takes it further — when you click a data point, the selected dimension value is applied as a **filter across all other metrics** on the same dashboard.

For example, if you click "West" on a revenue-by-region bar chart, every other metric on the dashboard (customer count, order trends, product breakdown) automatically filters to show only data for the "West" region.

This is useful for:

* **Multi-metric correlation analysis** — see how a dimension selection impacts all KPIs simultaneously
* **Interactive executive dashboards** — let stakeholders click once and see the full picture
* **Customer-facing dashboards** — provide self-service exploration without building separate filtered views

***

## How It Works

When Cross Dashboard Drill Down is enabled on a metric:

1. You click a data point (e.g., a bar segment for "West")
2. The system extracts the drilled dimension and its value (e.g., `region = 'West'`)
3. This value is applied as a **row-level security (RLS) filter condition** to all other metrics on the dashboard
4. All metrics re-query their data with the additional filter applied
5. The entire dashboard updates to reflect the selected dimension value

<Note>
  Cross-dashboard drill-down filters work alongside existing dashboard filters. Both are applied simultaneously — the drill filter does not replace your dashboard filters, it adds to them.
</Note>

***

## Setting Up Cross Dashboard Drill Down

### 1. Activate Cross Dashboard Drill Down

On the metric page, click the **"Settings"** icon, navigate to the **"Actions"** tab, and enable the **"Drill down"** toggle. Then activate **"Cross Dashboard Drill Down"** beneath it.

<Frame>
  <img src="https://mintcdn.com/databrainlabs-bef6850a/w40i74o67wVB_OZm/images/guides/activate-cross-dashboard-drilldown.png?fit=max&auto=format&n=w40i74o67wVB_OZm&q=85&s=f6f83846d2f99bc096cfe2a291233ae0" alt="Settings panel showing how to activate cross dashboard drill down" width="2940" height="1656" data-path="images/guides/activate-cross-dashboard-drilldown.png" />
</Frame>

### 2. View Changes in the Dashboard

Click on a segment of the chart where drill down is enabled. All other metrics on the dashboard will update to reflect the selected value.

<Frame>
  <img src="https://mintcdn.com/databrainlabs-bef6850a/vbx9KWWI3AEksWha/images/guides/view-cross-dashboard-drilldown.gif?s=a7ae23ba505b6b97edbb2d11d8f4c024" alt="GIF demonstrating cross dashboard drill down interaction on chart" width="1628" height="920" data-path="images/guides/view-cross-dashboard-drilldown.gif" />
</Frame>

### 3. Clear the Cross-Dashboard Filter

Click on the **same dimension** in the drilled-down chart to revert all changes and remove the cross-dashboard filter.

<Frame>
  <img src="https://mintcdn.com/databrainlabs-bef6850a/FXACK5bS1yJQ_mT1/images/guides/disable-drill-down.png?fit=max&auto=format&n=FXACK5bS1yJQ_mT1&q=85&s=2023389ee5015b0740713742e6c38d0b" alt="Chart image showing how to disable drill down and revert view" width="2940" height="1658" data-path="images/guides/disable-drill-down.png" />
</Frame>

***

## Which Metrics Are Affected?

When you trigger a cross-dashboard drill, the filter is applied to **all metrics on the same dashboard**. The drilled value is passed as an additional filter condition to every metric's query.

* Metrics whose underlying data **includes the drilled column** will filter their results accordingly.
* Metrics whose queries **do not reference that column** may show no change or may return an error depending on the SQL generated. For best results, ensure metrics on the same dashboard share common dimensions when using cross-dashboard drill.
* The filter uses the column name from the drilled metric, so consistent naming across metrics improves reliability.

***

## Cross Dashboard vs. Regular Drill Down

| Behavior        | Regular Drill Down        | Cross Dashboard Drill Down                  |
| --------------- | ------------------------- | ------------------------------------------- |
| Scope           | Single metric only        | Entire dashboard                            |
| Other metrics   | Unaffected                | Filtered by drilled value                   |
| Use case        | Deep-dive into one metric | Correlated analysis across metrics          |
| Clearing        | Breadcrumb navigation     | Click the drilled dimension again           |
| Can be combined | Yes — enable both         | Yes — cross-dashboard adds to regular drill |

You can enable both regular drill-down and cross-dashboard drill-down on the same metric. The cross-dashboard filter applies to other metrics while the originating metric drills into its own hierarchy.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Other metrics don't update when I drill" icon="table-columns">
    **Cause:** Cross Dashboard Drill Down is not enabled, or other metrics don't share the drilled column.

    **Fix:**

    * Verify **Cross Dashboard Drill Down** is enabled in the originating metric's **Settings > Actions** tab.
    * Check that other metrics on the dashboard have the same dimension column (by name or alias) as the drilled value.
  </Accordion>

  <Accordion title="Dashboard filters conflict with cross-dashboard drill" icon="filter">
    **Cause:** Both dashboard filters and the cross-dashboard drill filter are applied simultaneously.

    **Fix:**

    * This is expected behavior — both filters are additive. If the dashboard filter already restricts to a different value, the combined filter may return no data.
    * Clear either the dashboard filter or the cross-dashboard drill to see results.
  </Accordion>

  <Accordion title="Cannot clear the cross-dashboard filter" icon="xmark">
    **Fix:** Click on the **same dimension value** in the originating chart (the one where you first drilled) to clear the cross-dashboard filter and restore all metrics.
  </Accordion>
</AccordionGroup>

<Check>
  You've successfully enabled Cross Dashboard Drill Down.
  Your dashboard now responds dynamically to drilled dimensions, giving users deeper, interconnected analysis across views.
</Check>
