The Google Analytics Validator is a Google Sheets add-on. It lets you build a spreadsheet of all the accounts, properties, and views you have access to in Google Analytics. Then, you can select any number of these properties to populate a second sheet, where each Custom Dimension configured in the property is displayed with its name, scope, and active status.

Finally, you can poll for the last 7 days data for any selected property/view to see if the Custom Dimension has collected any hits. The add-on is completely free to use. It’s a hobby project, but I would still welcome any feedback. You can send the feedback to simo (at)

How to get it

In Google Sheets, open the Add-ons menu, and click Get add-ons.

You should see the Chrome web store window open. Enter “google analytics validator” into the search field and press Enter. You should see the add-on appear in the search results. Click the + FREE button. You will be asked to sign in with your Google ID, and then approve the add-on access to your data. The add-on requires read-only access to your Google Analytics data, and read and write access to your Google Sheets account.

You are then ready to use the tool!

GitHub repo

You can download the open-source code from the GitHub repo: ga-validator-apps-script.

How it works

You should see the Google Analytics Validator menu item in the Add-ons menu. You might need to reload the page if it isn’t there, or if it seems to be missing all its menu items.

First, click on 1. Build Google Analytics hierarchy. This collects all the Google Analytics accounts, properties, and views you have access to, and builds them into a new sheet with the name “GA Hierarchy”.

NOTE! If this sheet already exists, it is overwritten.

Next, type the letter x or X in the Select for analysis (x/X) column for each property/view that you want to include in the Custom Dimension analysis.

Once you’re done, click on 2. Run validator in the menu. This creates a new sheet named “GA Dimensions” (overwriting any existing sheet with the name), where all the dimensions from 1-200 are populated with values drawn from the properties you selected for analysis.

Finally, you can select any cell in a data column, and then click 3. Fetch last 7 days data… in the menu. This populates the LAST 7 DAYS column for the given view, fetching data from the last 7 days for each dimension that is active. The data that is fetched is the ga:hits metric.

This tool has three purposes:

  1. It gives you a master list of accounts, properties, and views you have access to.

  2. It lets you see how Custom Dimensions are configured across properties.

  3. It lets you analyze which Custom Dimensions have not collected any data recently.

Privacy Policy

What information do you collect?

The Google Analytics Validator collects no information from its users. It is an API tool for building sheets of data based on your Google Analytics account and data hierarchy, and no usage information is collected or used in any way.

The only thing the add-on logs is the generic Google Cloud Console API usage statistics, which tells the owner how much the enabled APIs are being used, but this data cannot be use to identify users or individual use patterns.

How do you use the information?

No user or usage information is used. The only thing the owner monitors is API usage, so that it can be determined if quotas need to be increased to ensure the tool works smoothly.

What information do you share?

No information is shared with third parties, with other users, with analytics tools, with marketing partners, or any other party.

Terms of Service

Terms of Service (“Terms”)

Last updated: October 30, 2018

Please read these Terms of Service (“Terms”, “Terms of Service”) carefully before using the Google Analytics Validator extension (the “Service”) operated by Simo Ahava (“us”, “we”, or “our”).

Your access to and use of the Service is conditioned on your acceptance of and compliance with these Terms. These Terms apply to all visitors, users and others who access or use the Service.

By accessing or using the Service you agree to be bound by these Terms. If you disagree with any part of the terms then you may not access the Service.

Our Service may contain links to third-party web sites or services that are not owned or controlled by us.

We have no control over, and assume no responsibility for, the content, privacy policies, or practices of any third party web sites or services. You further acknowledge and agree that we shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods or services available on or through any such web sites or services.

We strongly advise you to read the terms and conditions and privacy policies of any third-party web sites or services that you visit.

Governing Law

These Terms shall be governed and construed in accordance with the laws of Finland, without regard to its conflict of law provisions.

Our failure to enforce any right or provision of these Terms will not be considered a waiver of those rights. If any provision of these Terms is held to be invalid or unenforceable by a court, the remaining provisions of these Terms will remain in effect. These Terms constitute the entire agreement between us regarding our Service, and supersede and replace any prior agreements we might have between us regarding the Service.


We reserve the right, at our sole discretion, to modify or replace these Terms at any time. If a revision is material we will try to provide at least 30 days notice prior to any new terms taking effect. What constitutes a material change will be determined at our sole discretion.

By continuing to access or use our Service after those revisions become effective, you agree to be bound by the revised terms. If you do not agree to the new terms, please stop using the Service.

Contact Us

If you have any questions about these Terms, please contact us.