Dashboards are the main hub of your Heap account. They are used to organize relevant charts in the same space to review all of your metrics in one place. You can create as many dashboards as you need, and organize them into categories by team, feature, release, and more.

We recommend building out high-level dashboards that span multiple teams to get a summary of how the needles are moving, and building focused dashboards to understand the depth of analysis.

Building Dashboards

There are two ways to build a new, blank dashboard of your own. The first way is to click the New dashboard button from the Dashboards page.

The second way to create a new dashboard is while viewing a chart. Click Chart actions and Add to dashboard, then a pop-up will prompt you to either select an existing dashboard or create a new one by clicking the + Add to new dashboard button.

When you create your new blank dashboard, you’ll see options to give your dashboard a name, add a description, and preview whichever charts you choose.

When you are satisfied with your new dashboard, click Save dashboard. You will then be given the option to select the level of visibility you want and to categorize it.

Starring Dashboards

You can star Dashboards you view frequently to make it easier to view them all in one place. Click the star icon next to the dashboard’s name to include it in your list of starred dashboards. Starred dashboards will always appear at the top of their category.

Adding Charts to Dashboards

You can add charts to a dashboard either from the dashboard itself or from the charts page. To add charts from the dashboard itself, click Dashboard actions and then Add charts to dashboard.

A pop-up will appear where you can search for charts and select multiple charts to add to the dashboard. Click the Add charts button when you are done making your selection.

From the All charts page you can add multiple charts to a dashboard by selecting the checkbox next to the charts and clicking the Add to Dashboard button.

Note: If a selected chart already belongs on a dashboard, it will not be added to that dashboard again. Only selected charts that don’t already belong on the dashboard will be added.

Dashboards can hold a maximum of 100 charts. You can add graph, funnel, retention charts to dashboards.

Managing Dashboards

Once you have several charts in a dashboard, you can drag the chart cards to rearrange them to your liking.

You can also resize the dashboard cards to make certain charts more prominent than others. Click the ellipses (three vertical dots) icon in the chart card you wish to resize, then select the option for the size you want the chart to have.

Dashboard queries are cached for 24 hours from the time the dashboard was last visited. If you need up-to-date data, you can always click the Refresh button in the dashboard toolbar.

Within a dashboard, you can click the chart title to be taken to the corresponding chart and analysis module.

You can organize your dashboards using the same categories you use across your account to keep things neat and tidy. Dashboards can also be created, copied, and moved between personal spaces and shared spaces. While viewing a dashboard, click Dashboard actions to see the menu of options.

Filtering Dashboard Results

You can filter dashboard results by account, event, or user-level properties to get additional insight into user engagement. You can use this to:

• Filter a feature adoption or usage dashboard by region, browser, device type, or most recent NPS score, which lets you see how one segment of users are doing at a glance.
• Filter a traffic or conversion dashboard by UTM or marketing channel, which enables marketers to quickly zoom in on how your marketing campaigns are performing.
• Filter a feature adoption dashboard by CSM or Account Manager as a way of using dashboards as scorecards or punch lists.

To add a filter, from the Dashboard page, click the + Add Filter button.

Select the property you want to filter by. Once you save your selection, you’ll be able to apply modifiers to the filter.

You can share a filtered Dashboard by copy-pasting the exact URL of the Dashboard, which will include the filters you’ve added. 

Note: Dashboard filters are currently not set up to support Behavioral Properties or funnel conversion windows.

Dashboard Templates

Dashboard templates automate the creation of dashboards by pre-populating useful charts based on your use case.

To create a dashboard via a template, complete the following steps: 

1. Navigate to Dashboards and click the New dashboard button at the top of the Dashboards tab. Click Explore templates and choose a template that best matches your use case. In the example below, we selected the Acquisition overview template.
2. After you’ve selected a template, you’ll be prompted to select definitions that correspond to your use case. If you don’t have an existing event for these fields, you can define a new event by clicking Define new. For certain properties, you can select the default property that comes out-of-the-box when you install Heap.

4. Once you’ve made your selections, the dashboard will automatically populate with the relevant charts. You can continue to edit the events you’ve selected until you are satisfied. Once you are happy with your selections, click Save Dashboard to save your new dashboard!

With your new dashboard in place, you can add charts, customize individual chart settings, recategorize it to align with your organization’s categories, and more. The steps for doing so are the same as for any other dashboard, so see the Managing Dashboards section above for more info.