User properties

This same functionality is also available in Google Analytics 4 properties. Learn more
In this article:

About user properties

Set 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 filter your reports. For example, you can see how the game-play habits of spenders differ from non-spenders.

Each Firebase project 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) or setUserPropertyString (iOS) in your tracking code, refer to the developer documentation.


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 your app.
  2. Click User Properties.
  4. 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:

  1. In Analytics, navigate to your app.
  2. Click User Properties.
  3. In the row for that property, click More > 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.

Was this helpful?
How can we improve it?