Scorecard reference

How to use and configure scorecards.

Scorecards display a summary of a single metric. Scorecards are commonly used to visualize key performance indicators: some variable that measures the relative health or performance of your business or area of activity. For example, a scorecard can summarize total sales, average bounce rate, count of ad impressions, maximum hold time, minimum failure rate, etc.

In this article:

Scorecards in Data Studio

Scorecards in Data Studio appear as numbers, and, optionally, the name of the metric being summarized. The format of the displayed number depends on how the metric is configured in your data source.


The data source for a fictional pet store contains the following metrics. The Qty Sold metric is simply a number coming from the data set. The Avg Qty Sold metric is a duplicate of the Qty Sold field, with the Average aggregation type. Total Items, and Unique Items are calculated fields.

Name Calculation Aggregation Type
Qty Sold none Sum
Avg Qty Sold none Average
Total Items COUNT(Items) Auto
Unique Items COUNT_DISTINCT(Items) Auto

Scorecards for these metrics might look like this:

Scorecard examples

Configure the chart

Select the chart, then on the right, use the properties panel to configure the chart options.

Setup properties

The options in a chart's setup panel determine how the data is organized and displayed.

Data source

A data source provides the connection between the component and the underlying data set. 

  • To change the chart's data source, click the current data source name.
  • To view or edit the data source, click Edit. (You must have at least view permission to see this icon.)
  • Click +BLEND DATA to see data from multiple data sources in the same chart. Learn more about data blending.

Date range dimension

This option appears if your data source has a valid date dimension. For Google Ads and Analytics data sources, this option is automatically set to the Date dimension.

The Date range dimension is used as the basis for limiting the date range of the chart. For example, this is the dimension used if you set a date range property for the chart, or if a viewer of the report uses a date range control to limit the time frame.


Metrics measure the things contained in dimensions and provide the numeric scale and data series for the chart.

Metrics are aggregations that come from the underlying data set, or that are the result of implicitly or explicitly applying an aggregation function, such as COUNT(), SUM(), or AVG(). The metric itself has no defined set of values, so you can’t group by it, as you can with a dimension.

Learn more about aggregation.

Default date range

The Default date range property lets you set a timeframe for an individual chart.

Default date range options

Auto Use the default date range determined by the chart's data source.
Custom Lets you use the calendar widget to select a custom date range for the chart.
Date compare type Displays comparison data for the selected time period.

Learn more about working with dates and time. 


Filters restrict the data that is displayed in the component by including or excluding the values you specify. Learn more about the filter property.

Filter options

Filter name Click an existing filter to edit it. Mouse over the filter name and click X to delete it.
+Add a filter Click this option to create a new filter for the chart.

Style properties

A chart's style properties control the overall presentation and appearance of the chart.

Primary metric

These options control the appearance of the scorecard's current data.

Compact Numbers Rounds numbers and displays the unit indicator. E.g., 553,939 becomes 553.9K.
Decimal Precision Sets the number of decimal places in metric values.

Comparison metric

These options control the appearance of the scorecard's previous period comparison data.

Positive change color This option appears when date comparison is enabled. Changes the font color used to indicate positively changing (i.e., upward trending) data.
Negative change color This option appears when date comparison is enabled. Changes the font color used to indicate negatively changing (i.e., downward trending) data.
Show absolute change This option appears when date comparison is enabled. Changes the comparison display from percentage of change to absolute numeric difference.
Hide comparison label Hides the label that shows the comparison period.


This section controls the appearance of the chart labels.

Font color Changes the font color of the scorecard label.
Font size Changes the font size of the scorecard label.
Font family Changes the font family of the scorecard label.
Hide Metric Name Hides the default metric name (which comes from the data source). You can use the Text tool to add a custom metric label.
Alignment Align the metric name, primary value, and comparison value.

Missing data

This option appears when your time dimension is missing data. Data Studio offers 3 ways of dealing with this situation.

Note: this option has no effect on bar series. The Line to Zero option will affect a trendline, however.

Line to Zero When you select this option, a line series will drop to zero for the missing dates. This is the default option.
Line Breaks When this option is selected, missing data appears as breaks in the data series.
Linear Interpolation When this option is selected, Data Studio will continue the series by connecting the data points on either side of the missing data.

Background and border

These options control the appearance of the chart background container.

Background Sets the chart background color.
Border Radius Adds rounded borders to the chart background. When the radius is 0, the background shape has 90° corners. Border radius of 100° produces a circular shape.
Opacity Sets the chart's opacity. 100% opacity completely hides objects behind the chart. 0% opacity makes the chart invisible.
Border Color Sets the chart border color.
Border Weight Sets the chart border line thickness.
Border Style Sets the chart border line style.
Add border shadow Adds a shadow to the chart lower and right borders.


Use these options to control the line height and left, right, and top padding within the chart.


Chart Header

The chart header lets viewers perform various actions on the chart such as exporting the data or viewing the chart in the Explorer tool. Chart header options are:

Show on hover (default) Three vertical dots appear when you mouse over the chart header. Click these to access the header options.
Always show The header options always appear.
Do not show The header options never appear. Note that report viewers can always access the options by right clicking the chart.
Color Set the color of the chart header options.


Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center