Custom user properties

This help center article is part of the App + Web Property Beta.

App + Web properties are not currently supported in the Analytics app.

About 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.

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


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.


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:

  1. In Analytics, navigate to the reports for your App + Web property.
  2. In the left pane, click User Properties.
  4. Enter a name and description for the user property, then click CREATE.

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 App + Web properties.

Related resources

Learn more about automatically collected user properties.

Was this helpful?
How can we improve it?