QUERY function

Runs a Google Visualisation API Query Language query across data.

Sample usage

QUERY(A2:E6,'select avg(A) pivot B')



QUERY(data, query, [headers])

  • data – The range of cells to perform the query on.

    • Each column of data can only hold boolean, numeric (including date/time types) or string values.

    • In case of mixed data types in a single column, the majority data type determines the data type of the column for query purposes. Minority data types are considered null values.

  • query – The query to be performed, written in the Google visualisation API query language.

  • headers[ OPTIONAL ] – The number of header rows at the top of data. If omitted or set to -1, the value is guessed based on the content of data.


Make a copy

Note: Each example is in its own tab.

Sample data


Select and Where

Returns rows that match the specified condition using Select and Where clauses.


Group by

Aggregates Salary values across rows using Select and Group by clauses.



Transforms distinct values in columns into new columns.


Order by

Aggregates Dept values across rows and sorts by the maximum value of Salary.



Specifies the number of header rows in the input range, which enables transformation of multi-header rows range input to be transformed to a single row header input.

Was this helpful?
How can we improve it?
Visit the Learning Center

Using Google products, like Google Docs, at work or school? Try powerful tips, tutorials, and templates. Learn to work on Office files without installing Office, create dynamic project plans and team calendars, auto-organize your inbox, and more.

Clear search
Close search
Google apps
Main menu
Search Help Centre