Custom user properties

About user properties

You need Edit permission to set and register user properties.

Set custom user properties to identify static or slowly changing attributes of your users, such as "spender=true", "profession=engineer", or "favorite_team=Real Madrid". User properties are effectively sticky event parameters that are automatically logged when you call logEvent. After you create and register user-property values, you can use them to create comparisons in your reports. For example, you can see how the game-play habits of spenders differ from non-spenders.

Each Analytics property can have up to 25 uniquely named (case-sensitive) user properties.

When you set user properties, be sure to never include personally identifiable information such as names, social security numbers, or email addresses, even in hashed form.

If you archive a custom user property that is currently included in a report, then data for that user property will no longer appear in the report. The data will continue to appear in reports during the 48-hour grace period during which you can archive and restore a custom user property. If you restore the user property within the 48-hour period, there will be no interruption of data appearing in reports.

Summary table

The summary table lists the user properties that you set in your Analytics tracking code and then register in the Analytics interface.

Set and register a user property

Set

You set user properties in your Analytics tracking code.

For information about calling setUserProperty (Android) and setUserPropertyString (iOS), refer to the developer documentation. For information on how to set user properties for web, refer to User properties.

Register

In order to apply a user property as a report filter, you need to register it in the Analytics interface. Filtering is possible on data received from the day of registration onwards. To register a new user property:

In Analytics, navigate to the reports for your Google Analytics 4 property.
In the left pane, click User Properties.
Click NEW USER PROPERTY.
Enter a name and description for the user property, then click CREATE.

Archive user properties

If you have reached your limit of 25 user properties and need to create new ones, you can archive the ones that are no longer relevant, and then after 48 hours, create a new one.

During the first 48 hours after archiving a user property, you can restore it. After 48 hours, the user property is permanently archived.

To archive a user property:

In Analytics, navigate to your app.
Click User Properties.
In the row for that property, click > Archive.

To restore a user property during the 48 hours after archiving, you set and register a new property with the same name per the instructions in the preceding section.

Limits and guidelines

Learn more about the limits and guidelines you need to observe when collecting user data.

Measurement Protocol is not currently available for Google Analytics 4 properties.

Related resources

Learn more about automatically collected user properties.

Was this helpful?

How can we improve it?