User properties are attributes used to define segments of your user base, such as language preference or geographic location.
By default, Google Analytics 4 automatically logs some user properties like the ones below:
Technically speaking, the custom dimensions which have user scope are called the user-scoped custom dimensions (also known as user properties)
User-scope means the value of the custom dimension is calculated and sent once for each user.
Google recommends that you use a user-scoped custom dimension to identify static or slowly changing attributes of your website/app users like changes in the subscription plan, membership level, game difficulty level, etc.
You can create a user-scoped custom dimension by registering a parameter with user scope in the GA4 user interface.
In GA4, the values of custom dimensions and custom metrics are supplied by logged event parameters.
So, before you create a user-scoped custom dimension, you need a logged event parameter in your GA4 reporting view, and this parameter must have user scope.
In other words, you cannot create a user-scoped custom dimension by registering a parameter with event scope.
For example, the page_title has event scope, so you cannot register this parameter as a user-scoped custom dimension.
You can only register parameters as user-scoped custom dimensions if they have user scope.
You can also create a user-scoped custom dimension before logging the event parameter, but that is not best practice for creating user-scoped custom dimensions.
How to create and passa user scope custom parameter along with an event?
Before creating a user-scoped custom dimension, you need a user-scoped parameter that is logged (recorded) in your GA4 reporting view.
Let us suppose that you want to send the client ID custom parameter (with user scope) along with an event to your GA4 reporting view.
To send the client ID with user scope, you need to either create or edit a GA4 event tag in your GTM account and then send the client ID event parameter as a user property:
From the screenshot above, we can conclude that we are sending the client ID via the ‘client_id_custom‘ user property (aka user-scoped custom dimension) along with the event ‘get_user_data‘.
Note: If you want to learn more about sending client ID to your GA4 property, check out this article.
Once you start sending the client ID as a user property to your GA4 reporting view, navigate to the DebugView report:
Find and click on the user property named ‘client_id_custom= ……‘:
You should now be able to see one of the captured client IDs:
Let us suppose you want to register the user-scoped custom parameter ‘client_id_custom’ as a user-scoped custom dimension.
To do that, follow the steps below:
Step-1: Navigate to your GA4 property view and then click on the ‘Configure’ link:
Step-2: Click on ‘Custom Definitions’
Step-3: Click on the ‘Create custom dimensions’ button:
Step-4: Enter the name for your custom dimension. This name will appear in your GA4 reports, so use a descriptive name:
Note: You can always change the dimension name later if you need to.
Step-5: Set the dimension scope to ‘User’:
Note: Once you have set the scope, you cannot change it later.
Step-6: Select the parameter ‘client_id_custom’ from the ‘User property’ drop-down menu and then click on the ‘Save’ button:
Note: Once you have selected a user property, you cannot change it later.
You should now see your new custom dimension listed under the ‘Custom dimensions’ section:
Once a full 24 hrs have elapsed, your user-scoped custom dimension should be available in the various GA4 reports.
However, the user-scoped custom dimension won’t appear as a data card in every event report where you (or GA4) pass the user-scoped parameter along with the event. The data card appears only for event-scoped custom dimensions.
Then navigate to Engagement > Events report in your GA4 reporting view:
Click on the ‘get_user_data’ event:
You will see the report on the ‘get_user_data’ event, but you won’t see a separate data card for the user-scoped custom dimension ‘Custom Client ID’:
Applying user-scoped custom dimensions via ‘Add Comparison’
Once you have registered a logged event parameter as a user-scoped custom dimension, you can then apply the custom dimension to any GA4 report via the ‘Add Comparison’ feature.
In GA4, we use the ‘Add Comparison’ feature (instead of segments or filters) to evaluate and compare a subset of data.
Let’s apply the ‘Custom Client ID’ user-scoped custom dimension we created earlier to the Traffic Acquisition report.
Follow the steps below:
Step-1: Navigate to the Traffic Acquisition report in your GA4 reporting view:
Step-2: Click on the ‘Add Comparison’ button:
You should now see an overlay on the right-hand side of your screen like the one below:
Step-3: Select the ‘Custom Client ID’ dimension from the ‘Dimension’ drop-down menu:
Step-4: Click on the ‘Dimension Values’ drop-down menu:
Step-5: Select one of the client IDs and then click on the ‘OK’ button:
Step-6: Click on the ‘Apply’ button:
You should now see the new comparison added to the Traffic Acquisition report:
Navigate to any other GA4 report, and you should see the same new comparison applied to the report.
That’s how you can apply user-scoped custom dimensions to GA4 reports via the ‘Add Comparison’ feature.
The advantage of registering a user-scoped event parameter as a user-scoped custom dimension is that you can report on the same user-scoped event parameter for as many events as you like without passing the same parameter repeatedly for each event.
Applying a user-scoped custom dimension as a secondary dimension
Once you have registered a logged user-scoped event parameter as a user-scoped custom dimension, you can then apply the custom dimension as a secondary dimension to any GA4 report which contains a data table.
For example, the User Acquisition report contains a data table:
Click on the ‘+’ button next to the ‘User medium’ primary dimension to apply a secondary dimension to the data table:
Click on ‘Custom (User-scoped)‘ from the drop-down menu:
Click on ‘Custom Client ID‘:
You should now see the ‘Custom Client ID’ user-scoped custom dimension applied to the User Acquisition report as the secondary dimension:
That’s how you can apply a user-scoped custom dimension to GA4 reports as a secondary dimension.
Note: Just like event-scoped custom dimensions, you can also apply user-scoped custom dimensions to the Analysis Hub reports.
Archive user properties in GA4
Since Google Analytics provides only 25 custom user properties, if at any time you exceed the limit or do not want to continue with an existing user property, you can archive any of the current user properties which are no longer needed or are of less importance.
Follow the below steps to archive a user property:
Step-1: Navigate to your GA4 property view and then click on the ‘Configure’ link:
Step-2: Click on ‘Custom Definitions’.
Step-3: Click on the three dots menu next to the user property (aka user-scoped custom dimension) you want to delete:
Step-4: Click on the ‘Archive‘ option:
Step-5: Click on the ‘Archive’ button:
Note: Archiving a user property is permanent. It cannot be undone, and the corresponding data cannot be restored. Any segment or funnel using this user property in Analysis would stop working.
Adding the user property to your website via gtag.js
User properties can be set either by calling the gtag(‘set’) command in your website if you are using the global site tag (gtag.js) tagging framework or using Google Tag Manager.
Here I will be creating a user property ‘User_Location’ as an example.
You can pass user properties using the following command.
Frequently asked questions about GA4 User Properties (User scope custom dimension)
What are user properties (user scope custom dimensions) in Google Analytics 4?
User properties are attributes used to define segments of your user base, such as language preference or geographic location. By default, Google Analytics 4 automatically logs some user properties like the ones below: Technically speaking, the custom dimensions which have user scope are called the user-scoped custom dimensions (also known as user properties) User-scope means the value of the custom dimension is calculated and sent once for each user.
How to create a user property in GA4?
Follow the below steps to create user property in GA4 Step-1: Navigate to your GA4 property view and then click on the ‘Configure’ link Step-2: Click on ‘Custom Definitions’ Step-3: Click on the ‘Create custom dimensions’ button Step-4: Enter the name for your custom dimension. This name will appear in your GA4 reports, so use a descriptive name Step-5: Set the dimension scope to ‘User’ Step-6: Select the parameter ‘User parameter’ (which you are sending with an event in GA4) from the ‘User property’ drop-down menu and then click on the ‘Save’ button
How many user properties can be created in Google Analytics 4?
You can create up to 25 User properties in GA4 per property.
Register for the FREE TRAINING...
"How to use Digital Analytics to generate floods of new Sales and Customers without spending years figuring everything out on your own."
Here’s what we’re going to cover in this training…
#1 Why digital analytics is the key to online business success.
#2 The number 1 reason why most marketers are not able to scale their advertising and maximize sales.
#3 Why Google and Facebook ads don’t work for most businesses & how to make them work.
#4 Why you won’t get any competitive advantage in the marketplace just by knowing Google Analytics.
#5 The number 1 reason why conversion optimization is not working for your business.
#6 How to advertise on any marketing platform for FREE with an unlimited budget.
#7 How to learn and master digital analytics and conversion optimization in record time.
My best selling books on Digital Analytics and Conversion Optimization
Maths and Stats for Web Analytics and Conversion Optimization
This expert guide will teach you how to leverage the knowledge of maths and statistics in order to accurately interpret data and take actions, which can quickly improve the bottom-line of your online business.
Master the Essentials of Email Marketing Analytics
This book focuses solely on the ‘analytics’ that power your email marketing optimization program and will help you dramatically reduce your cost per acquisition and increase marketing ROI by tracking the performance of the various KPIs and metrics used for email marketing.
Attribution Modelling in Google Analytics and BeyondSECOND EDITION OUT NOW!
Attribution modelling is the process of determining the most effective marketing channels for investment. This book has been written to help you implement attribution modelling. It will teach you how to leverage the knowledge of attribution modelling in order to allocate marketing budget and understand buying behaviour.
Attribution Modelling in Google Ads and Facebook
This book has been written to help you implement attribution modelling in Google Ads (Google AdWords) and Facebook. It will teach you, how to leverage the knowledge of attribution modelling in order to understand the customer purchasing journey and determine the most effective marketing channels for investment.
About the Author
Himanshu Sharma
Founder, OptimizeSmart.com
Over 15 years of experience in digital analytics and marketing
Author of four best-selling books on digital analytics and conversion optimization
Nominated for Digital Analytics Association Awards for Excellence
Runs one of the most popular blogs in the world on digital analytics
Consultant to countless small and big businesses over the decade
Learn and Master Google Analytics 4 (GA4) - 126 pages ebook
We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL the cookies.
This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.
Necessary cookies are absolutely essential for the website to function properly. These cookies ensure basic functionalities and security features of the website, anonymously.
Cookie
Duration
Description
cookielawinfo-checkbox-analytics
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics".
cookielawinfo-checkbox-functional
11 months
The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
cookielawinfo-checkbox-necessary
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
cookielawinfo-checkbox-others
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other.
cookielawinfo-checkbox-performance
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
viewed_cookie_policy
11 months
The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
Functional cookies help to perform certain functionalities like sharing the content of the website on social media platforms, collect feedbacks, and other third-party features.
Performance cookies are used to understand and analyze the key performance indexes of the website which helps in delivering a better user experience for the visitors.
Advertisement cookies are used to provide visitors with relevant ads and marketing campaigns. These cookies track visitors across websites and collect information to provide customized ads.
Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics the number of visitors, bounce rate, traffic source, etc.