Metric blocks

Drag the number icon from the toolbar onto your dashboard to add a new metric block to the dashboard. Hover over the metric and click the cog icon to edit it. Want to dig deeper into your data? Click on any metric block when in view mode to see your metric in Explore.

Linked Metrics and Custom Metrics

Metric blocks in a dashboard can be defined as a reference to a metric from the Metrics page, or as a new custom metric that is only available in the dashboard it's defined in. Linked metric blocks will be updated if the corresponding metric definition changes at the project level allowing you to keep definitions centralized for key performance indicators across your organization.

Text labels

Heading: The label shown under the value of this metric.

Data settings

Linked metric settings

Defining linked metrics is as simple as choosing the name of project level metric definition you'd like to display in the dashboard. You can also choose whether or not dashboard filters will be applied to the block.

Metric Value: Choose a metric to be displayed in the dashboard block.

Ignore Dashboard Filters: Check this box if you want this metric to ignore dashboard filters. When this is set, only the filters specified on the metric will be used.

Custom metric settings

Metrics can be calculated as either Simple Metrics or Relative Comparison metrics. Simple Metrics calculate a value across all data in a filtered range whereas Relative Comparison metrics calculate a value over specific periods of data so you can see a metric value for the last week, month, etc. To start building a custom metric block from a metric that has already been created in the Metrics page you can use the 'Copy metric configuration' functionality. This allows you to start building metric blocks from a common base but changes to the metric copied will not affect the custom metric block.

Simple metrics

Metric Value: Choose a data model and metric to display.

Sparkline: Click the toggle to enable or disable a sparkline visualization of your metric. Select a date and granularity to go on the x axis of the sparkline.

Relative metrics

Metric Value: Choose a data model and measure to display. Then select the date that you want to aggregate the measure over and adjust the granularity to see values over the most recent week, month, etc of your dataset.

Sparkline: Click the toggle to enable or disable a sparkline visualization of your metric. Values will be plotted over the date you've selected to calculate the metric.

Comparison Text: When comparisons are enabled the block will display the difference between the value for the most recent period and the prior period in your data. For example, if you have your relative metric set to show user count over a month enabling this feature will show you the difference between users the last month of data and the prior month.

Filters

Adding Filters: Click the + icon in the "Filters" section to add filters to your metric. These filters will only apply to this metric, and will not be editable by viewers.

Updating Filters: Click on individual filter chips in the "Filters" section to edit or delete filters that exist on a metric.

Ignore Dashboard Filters: Check this box if you want this metric to ignore dashboard filters. When this is set, only the filters specified on the metric will be used.

Formatting

Up/Down Colors: If the metric is a Relative Comparison metric with comparison text enabled you'll be able to customize how negative and positive differences are displayed. Simply click into a color and change the values to a new color code. Positive differences will be displayed in the Up color and negative differences will be displayed in the Down color. This can only be configured for custom metric blocks.