Documentation Visual SQL (beta)

Visual SQL Drilldowns

Chartio’s Drilldown functionality allows you to click an area on a chart to update a Dashboard Control value. The Dashboard Control then updates any charts that are connected to it.

This is basically a two-part process:

  1. Map your chart metrics (Drilldown Variables) to Dashboard Controls
  2. Filter your chart(s) with the Dashboard Controls

This is best explained with an example. We’ll start by showing you what our final dashboard looks like, then we’ll explain how to connect everything together.

The final dashboard of this Drilldown Variables example

Interacting with the Monthly Activity chart updates two Dashboard Controls: the Calendar and the categorical Dropdown. The Dashboard Controls then update the Daily Activity chart. This gives us a zoomed-in view of our Activity by Activity Type.

Let’s walk through how to set this up. To begin with, we have two charts and two Dashboard Controls already on this Dashboard:

  1. Monthly Activity, a chart grouped by month and activity type
  2. Daily Activity, a chart grouped by day and activity type
  3. A Calendar Dashboard Control
  4. A categorical Dropdown Dashboard Control containing Activity values

Connecting your Charts

First, we want to connect Monthly Activity to our two Dashboard Controls. This will allow our chart to update the Dashboard Controls whenever we click somewhere inside the Monthly Activity chart.

We’ll click the menu icon on our Monthly Activity chart and select Edit Settings from the dropdown menu.

Monthly Activity Edit Settings

We’ll then switch to the Drilldown tab in the Chart Settings modal. This tab allows you to map Dashboard Controls to Drilldown Variables (your chart metrics).

Map your Dashboard Variables to Drilldown Variables in the Drilldown tab of the chart settings

We want to link two Dashboard Controls to our chart: ACTIVITY (the categorical Dropdown) and CALENDAR.

  • On our chart, Activity is the series (pivoted column), so we’ll choose series from the dropdown for ACTIVITY.
  • Our dates are on the x-axis, so we’ll choose x-value from the dropdown for CALENDAR.

Note: If your chart has x and y-axis labels, you’ll see those label names listed instead of ‘x-value’ and ‘y-value’.

To link your Drilldown chart to another Dashboard, simply choose the dashboard from the Linked Dashboard dropdown in the Drilldown tab of your chart settings. You’ll need to first add the necessary Dashboard Controls to the Linked Dashboard, so your chart can update them.

X-values, y-values, and series

Generally, x-values map to the x-axis, y-values to the y-axis, and series to the columns.

If you aren’t sure you’re selecting the correct chart metric to map to your Dashboard Control, check the sample values listed below the Drilldown Variables dropdown to confirm.

If your chart has x and y-axis labels, those labels will be listed in the Drilldown Variables dropdown instead.

Connect the Dashboard Controls to your Chart(s)

We want our Daily Activity chart to update when the Dashboard Controls change, so we’ll just need to filter our chart by our two Dashboard Controls.

On our Daily Activity chart, we’ll click the menu icon and choose Edit Chart Data.

Click Edit Chart Data from the Daily Activity chart menu

  • To connect our Activity Dropdown to the chart, we’ll add our Activity Name column to the Filters section:
    Activity Name is one of {ACTIVITY}
  • To connect our Calendar variable, we’ll also add the Created Date column to the Filters section:
    Created Date between and including {CALENDAR.START} and {CALENDAR.END}

Here’s what the Query looks like with our filters added:

Set up your Daily Activity chart

That’s it! Your Drilldown Variables should work as expected.

Additional Notes

  • For Table charts with Drilldown Variables, the selections are made per-row. If more than one Drilldown Variable is used in a Table chart, clicking a row value will update all Dashboard Controls for the row.
  • If you would like to use a Line chart or Scatter Plot for your Drilldown, you may want to edit the chart settings to increase the line or dot size. This will allow for easier click interactions.

If you have any trouble setting up your Drilldown Variables, please feel free to send us an email at