Notification

This Help Center is moving to Cloud. Learn more about the migration.

Filter by email address

Use email addresses to enable row-level data security.

Reports can request permission to access a report viewer's email address in order to personalize the data shown to that viewer. When users consent to sharing their email address with that report, the underlying data source can use that to return only the data associated with that email address. This is known as "row-level data security."

In this article:

Email filter examples

These examples use a data source that is based on Google Sheets to show how email filtering works.

Example 1

In this example, the data source is not filtered. All the data appears in the Looker Studio report.

A table chart that is not filtered by a user email displays all the values from a Google sheet that includes columns for Name, Favorite Food, and Favorite Number for all users in the spreadsheet.

Example 2

In this example, the data source has an email filter. Rick is signed in, so only his data appears when he views a report that is based on the filtered data source.

The table chart with Google Sheets data is filtered for the email rick@example-pet-store.com, and only the Name, Favorite Food, and Favorite Number values for that email are displayed in the chart.

Example 3

When Michelle signs in and views the same report, she sees only her data, as shown in example 3.

User Michelle views a report with the Google Sheets data restricted to email = daisy@example-pet-store.com. Only that user's Name, Favorite Food, and Favorite Number values are displayed in the chart.

Example 4

In this final example, Bob signs in and views the report. There is no data for his email address ([email protected]), so the Looker Studio chart is empty.

The table chart with Google Sheets data is filtered for the email bob@example-pet-store.com, and no data is displayed in the chart.

For viewers

When you view a report that includes a data source that uses row-level data security, all components that are based on that data source will ask you to allow them to use your email address.

You must be signed in to a Google account to view a report that uses email filtering.

A report displays a dialogue that consent is required to load the data and includes an Allow button for the user to select.

If you consent

All components in the report that are based on the data source that is requesting your email address will be able to show data that is relevant to you. You can revoke your consent at any time.

If you don't consent

All components in the report that are based on the data source that is requesting your email address will show only the consent request. They won't show any data.

For editors

Filtering by email is available for any kind of data source. If your data is in BigQuery, you can also use the email parameter in a custom query to filter by email address.

To use filtering by email address, your underlying data must contain a field that stores the email address for your report viewers. You can then create an email filter in the data source that uses that field. Looker Studio can then return the rows of data that contain the email address of the signed-in user.

For example, say you have a spreadsheet that records the performance of your company's sales representatives. Each row in the spreadsheet contains an email address for one of the sales reps. You can turn on email filtering in the data source that is connected to that spreadsheet. When a signed-in viewer views a report that is based on that data source for the first time, they'll be prompted to give their consent to let that report access their email address. The data source can then query for records that contain that address. Only matching records are shown, ensuring that the viewer only sees the data they're meant to see.

Create an email filter

  1. Edit your data source.
  2. In the upper left, click FILTER BY EMAIL.
  3. Turn on Filter data by viewer email.
  4. Select the field in your data source that contains viewer email addresses.
  5. To return to the data source editor, click ALL FIELDS.

Stop filtering by email

  1. Edit your data source.
  2. In the upper left, click FILTER BY EMAIL.
  3. Turn off Filter data by viewer email.

Filter by email in BigQuery

In a BigQuery data source, you can filter by email address using the @DS_USER_EMAIL parameter in a custom query. For example:

Select * from Sales WHERE sales-rep-email = @DS_USER_EMAIL;

This provides additional flexibility in your filters. Learn more about BigQuery parameters.

Filter by email in scheduled report delivery

You can include email address filters in reports that get delivered by scheduled email and Google Chat. When one or more of the data sources in that report have email filtering enabled, you'll see the Filter the delivered report data by recipient’s email address option when you're creating or editing your schedule.

Learn more about scheduled automatic report delivery.

Revoke access to your email

To stop providing your email address to reports that request it, you can revoke your consent by following these steps:

  1. Sign in to Looker Studio.
  2. In the upper right, click Settings Settings..
  3. On the left, select Revoke Consent. Next, under Revoke user email, click Revoke all.

After you revoke your consent, you'll need to grant it again before you can see personalized data in reports.

Limits of filter by email

  • Your underlying data set must contain the full email address of the viewers who will be accessing your report.
  • The case of the email addresses in your data must match the case in the users' accounts. For example, if a user's account belongs to "[email protected]" but your data contains "[email protected]", the filter won't match (and Bob won't see his data).
  • Viewers must sign in to view a report with email filtering applied, even if the report is shared publicly.
  • Viewers must consent to providing their email address.

Use data blending to filter by multiple email addresses per row.

Was this helpful?

How can we improve it?
true
What's new in Looker Studio?

Learn about new features and recent changes. Looker Studio release notes live on Google Cloud.

Search
Clear search
Close search
Google apps
Main menu
2367676371873873692
true
Search Help Center
true
true
true
true
true
102097
false
false