Functions in Google Data Studio are formulas which are used to: 

• Aggregate data. 
• Do mathematical calculations on your data.
• Manipulate time data. 
• Manipulate geographic location data. 
• Manipulate string data. 

Functions make your calculated fields more powerful. They are used inside of calculated fields as a formula.

If you remember, we used the ‘CASE’ function as a formula when dealing with boolean values:

‘CASE’ is just one of the many functions provided by Google Data Studio.

Google Data Studio provides over 50 functions that you can use inside of calculated fields as a formula.

Following are the typical attributes of a function in Google Data Studio

1. Every function in Data Studio has some purpose. 
2. Every function in Data Studio has syntax
3. All functions expect one or more parameters
4. Parameters are listed in the syntax
5. All functions return a value
6. Almost all functions have certain restrictions regarding how they can be used.

---

Get the ebook on Google Data Studio (50+ Pages)

---

#1 Every function in Data Studio has some purpose

For example, the ‘CASE’ function is used to create new fields that use conditional logic to determine the field values.

The ‘AVG’ function is used to calculate the average value of a numeric field.

Similarly, the ‘COUNT’ function is used to count the number of items in a field.

Note: You can learn more about the purpose of each function from the Google help documentation on each function: https://support.google.com/datastudio/topic/7019880?hl=en&ref_topic=7570421   

#2 Every function in Data Studio has syntax

Syntax defines how a function must be used. It defines how parameters (more about them later) must be used. 

For example, the following is the syntax for the CASE function:

CASE

    WHEN condition THEN result

    WHEN condition THEN result

    WHEN condition THEN result

    … 

    ELSE result 

END

Following is the syntax for ‘AVG’ function:

AVG(value)

Following is the syntax for ‘COUNT’ function:

COUNT(value)

Note: You can learn more about the syntax of each function from the Google help documentation on each function: https://support.google.com/datastudio/topic/7019880?hl=en&ref_topic=7570421   

#3 All functions expect one or more parameters

Parameters (also called ‘arguments’) are the input a function expects in Google Data Studio. The parameter tells the function of what data to act upon. 

Parameters can be field names or expressions. 

An expression can be a number, literal text, or a statement that evaluates to a field name in your data source. 

Parameters can also provide additional instructions or formatting information.

For example, CASE function expects the following parameters:

1. Condition
2. Result
3. Else result

#1 Condition—It is an expression which evaluates to a boolean value (true or false). Conditions can include dimensions or metrics but not both:

#2 Result – the value to return. It can be a dimension, metric, or literal value:

#3 ELSE result (optional) – It is the default value to return if no other condition is met.

Note(1): When providing parameters, be sure to enclose the literal text in single or double-quotes.
Note(2): You can learn more about the parameters used by each function from the Google help documentation on each function: https://support.google.com/datastudio/topic/7019880?hl=en&ref_topic=7570421
Note(3): You can click on the ‘Format Formula’ button, to make your formula more readable.

#4 Parameters are listed in the syntax

All the parameters which the CASE function expect, are listed in the syntax of the CASE function:

CASE

    WHEN condition THEN result

    WHEN condition THEN result

    WHEN condition THEN result

    … 

    ELSE result 

END

So if you remember the syntax, you would remember how to use the CASE function.

#5 All functions return a value

For example, ‘CASE’ function returns dimensions or metrics based on conditional expressions.

The ‘AVG’ function returns the average for all values in a field or expression.

Similarly, the COUNT function returns the total number of items in a field or expression.

Note: You can learn more about the values returned by each function from the Google help documentation on each function: https://support.google.com/datastudio/topic/7019880?hl=en&ref_topic=7570421   

#6 Almost all functions have certain restrictions regarding how they can be used

For example, when using the CASE function you can not compare dimensions to dimensions or metrics to metrics:

In Data Studio, you can compare a dimension or metric only with a literal value. 

Similarly, you can not apply the AVG function or COUNT function to a pre-aggregated field.

Note: You can learn more about such restrictions on each function from the Google help documentation on each function: https://support.google.com/datastudio/topic/7019880?hl=en&ref_topic=7570421   

More information on each function, including examples, is also available in the formula editor.

When you type a function name in the formula editor, Data Studio provides information about the function like its syntax, its purpose and its use case:

The bottom of the formula editor sometimes provides additional information about how a function is being used and how it should be used.  

For example, in the screenshot above, the Data Studio was expecting arguments (Expected arguments, but none were provided).

Types of Data Studio functions

All of the Data Studio functions are grouped into the following categories:

1. Aggregation functions
2. Arithmetic functions
3. Date functions
4. Geo functions
5. Text functions
6. Miscellaneous functions

Aggregation functions

These functions are used to aggregate data. 

Following are examples of aggregation functions:

1. APPROX_COUNT_DISTINCT
2. AVG
3. COUNT
4. COUNT_DISTINCT
5. MAX
6. MEDIAN
7. MIN
8. PERCENTILE
9. STDDEV
10. SUM
11. VARIANCE

Note: Aggregation functions can not be applied to already aggregated data. This includes most metrics found in Google Analytics and Google Ads. For example, Sessions is already summed in your data set, so the formula SUM(Sessions) will produce an error.

Arithmetic functions

These functions are used to do mathematical calculations on your data.

Following are examples of Arithmetic functions:

1. NARY_MAX
2. ACOS
3. ATAN
4. ABS
5. COS
6. FLOOR
7. LOG
8. LOG10
9. ASIN
10. NARY_MIN
11. POWER
12. ROUND
13. SIN
14. SQRT
15. TAN
16. CEIL

Date functions

These functions are used to manipulate time data. 

Following are examples of Date functions:

1. DATE_DIFF
2. DAY
3. HOUR
4. MINUTE
5. MONTH
6. QUARTER
7. SECOND
8. TODATE
9. WEEK
10. WEEKDAY
11. YEAR
12. YEARWEEK

Note: Date functions assume UTC as their timezone. Date functions can optionally take either an input or output (or both) format string.

Geo functions

These functions are used to manipulate geographic location data. 

Following are examples of Geo functions:

1. TOCONTINENT
2. TOCOUNTRY
3. TOREGION
4. TOSUBCONTINENT

Text functions

These functions are used to manipulate string data. 

Following are examples of text functions:

1. CONCAT
2. CONTAINS_TEXT
3. ENDS_WITH
4. LEFT_TEXT
5. LENGTH
6. LOWER
7. REGEXP_EXTRACT
8. REGEXP_MATCH
9. REGEXP_REPLACE
10. REPLACE
11. RIGHT_TEXT
12. STARTS_WITH
13. SUBSTR
14. TRIM
15. UPPER

Miscellaneous functions

Functions which do not fall in any of the below categories come under the ‘miscellaneous functions’ category:

1. Aggregation functions
2. Arithmetic functions
3. Date functions
4. Geo functions
5. Text functions

Following are the examples of miscellaneous functions:

1. CASE
2. CAST
3. HYPERLINK
4. IMAGE

Frequently Asked Questions About Google Data Studio Functions, Formulas Tutorial