Report publishing

​Work on a draft while viewers see the published report.

Report publishing lets you control when viewers see the changes you make to a report. By default, viewers see changes in real-time. Report publishing lets editors work on a draft version of a report while viewers see the published version. When you're ready to let viewers see the new version, you can then publish it.

In this article:

Turn on report publishing for a report

  1. Edit your report.
  2. Select File and then Publishing settings.
  3. Turn on report publishing.

To let viewers see changes to the report as you make them, turn this option off.

Publish changes

To publish a draft version:

  1. Edit your report.
  2. In the upper right, click Publish.
  3. In the confirmation dialog, click Publish.

Switch between draft and published reports in view mode

Viewers can only see the published report. Report editors can see either the draft report or the published report in view mode.

To switch between draft and published reports:

  1. View the report.
  2. In the upper left, next to the report name, click the selector, then select the version you want to view.

View published report or draft report.

How report publishing works

When you turn on report publishing, Data Studio publishes the current version of that report. Report editors can then work on the draft version until it's time to publish a new version. While you're editing the report, viewers only see the published version.

Publishing and version history

Version history for manually published reports has 2 current versions: the current published version, and the current draft version. Anyone editing the report works on the current draft version.

You can use version history to publish or restore previous versions of the report:

When you publish a previous version, report viewers will see that version of the report. The current draft version won't change.

When you restore a previous version, that becomes the new draft version. The published version of your report doesn't change.

Data source changes and report publishing

When report publishing is turned on, the following changes to the fields in an embedded data source won't appear to viewers until you publish the report:

  • Field name changes
  • Calculated field formula changes
  • Hiding / showing fields
Similar edits to reusable data sources will appear in both the draft and published versions.

Other data source changes that bypass report publishing

In addition, if you make any of the following changes to a data source of either type, the effects will be visible in the published report:

Revoke data source credentials

Revoking the credentials on a data source used in the published version of the report will cause charts using that data source to show a "failed to get data" error in the published version.

Remove a data source from the report

Removing a data source used in the published version of the report will cause charts using that data source to show an "unknown data source" error in the published version.

Moving a data source to the Trash

Moving a data source used in the published version of the report  to the Trash or deleting it forever will cause charts using that data source will return a "data set configuration error" in the published version.

Copy a report with report publishing turned on

The results of copying a report with report publishing turned on depends on your access to the report:

For editors:

  • The copy contains both the draft and published version. Report publishing remains on in the copy.

For viewers:

  • The copy only contains the published version of the report. The copy uses automatic publishing.
Was this helpful?
How can we improve it?