Clear search
Close search
Google apps
Main menu

Google Sheets connector

Connect to a Google Sheets worksheet or range.

Google Sheets is part of the Google Docs suite of productivity apps. Google Sheets lets you create and format online spreadsheets, and work on them simultaneously with other people. The Data Studio Google Sheets connector allows you to access data stored in a Google Sheets worksheet.

In this article:

How to connect to Google Sheets

A Google Sheets data source can connect to a single worksheet in a Google Sheet.

You can select from any of the spreadsheets that you own or that have been shared with you. You can also paste in the URL of a Google Sheet to which you have access.


Use first row as headers causes the data source to use the first row in your worksheet as the field names in the data source. If this option is not selected, the field names will use the column index (A, B, C, etc.)

Include hidden and filtered fields lets you include or exclude these fields from the data source. The default value is to include them. This option only applies to filters, not to filtered views. Learn more about filters in the Sheets Help Center.

Optional Range lets you define a range of cells in the selected worksheet. Use standard column-row syntax to define the range: e.g., A1:Z26.


Data Studio requires that the range or worksheet selected be in a tabular format.

The header row must be a single row.

All cells within a column should be of the same type.

The range or worksheet you select should represent a table. Mixing other non tabular data, charts, sparklines, or other non-data information will result in data quality issues in your reports.

Once you connect to a spreadsheet, you may only append, or remove columns from the sheet. Rearranging, inserting, or removing columns other than the last one is currently not supported and can lead to data quality issues. If you need to rearrange columns, you should create a new data source.

Was this article helpful?
How can we improve it?
What's new in Data Studio

Learn about new features and recent changes.