Let your viewers control the date range

Add a date range control to a report.

The date range control is a customizable calendar widget that enables your viewers to report change the time frame of a report.

In this article:

Watch a short video

Use date range controls

Date range controls give you a way to refine the time frame in a Data Studio report. Learn how to use and create them to make your reports and dashboards interactive.

In the video above, the steps shown for adding a date range control differ slightly from the latest version of Data Studio. If you haven't added a default date range to your report, you'll do that as part of adding a date range control, as described below.

Add a date range control to a report

  1. Edit the report.
  2. Select the Date Range tool from the toolbar. Date range control icon
  3. Draw the date range in a nice spot.
  4. In the Date Range Properties panel, DATA tab, select the default date range.
  5. Use the STYLE tab options to change the look of the widget as it appears on the report.

The Header properties apply to the calendar widget's header. You'll only see that in view mode.

How date range controls work

A date range control enables the report viewer to adjust the date range of the charts in a report. This lets the viewer restrict the data shown in those charts to a specified time frame. Date range controls appear to the user as a calendar widget on the report. Viewers can define a custom date range using the calendar, or using a drop-down of predefined ranges. The predefined options include ranges such as "Yesterday," "Last 7 days (including today)," and "Last quarter."

Date range controls and data sources

To add a date range control to a report, at least one of the data sources attached to the report must have a date dimension. Date range controls only affect charts built on data sources that have a date dimension.

Date range control scope

By default, a date range control governs all the charts on the page (assuming those charts come from a data source with valid date data). You can limit the scope of the date range control by doing either of the following:

1) Assigning a date range property to an individual chart overrides the date range control. The chart's date property will stay in effect.

2) Grouping a date range control with a chart limits the effect of the date range control to that chart. Any non-grouped charts will not be affected by the date range control.

Make a date range control appear on every page

By default, every component you place on a report is a page-level object: it only appears on the original page on which you place it. You can make a date range control appear on every page of your multi-page report by making it report-level. To do this:

  1. Edit the report.
  2. Select the date range control (or other component).
  3. Select the Align > Make Report-level menu.

Your date range control will now appear in the same location on every page of your report.

About dates and time in Data Studio

Was this article helpful?
How can we improve it?