Stay organized with collections
Save and categorize content based on your preferences.
User properties are attributes you define to describe segments of your
user base, such as language preference or geographic location. These can be used
to define audiences
for your app. This guide shows you how to set user properties in your app.
Analytics automatically logs some
user properties; you
don't need to add any code to enable them. If you need to collect additional
data, you can set up to 25 different user properties per project. Note that user
property names are case-sensitive and that setting two user properties whose
names differ only in case results in two distinct user properties being logged.
You can't use a small set of user property names reserved by Google:
Age
Gender
Interest
Before you begin
Make sure that you've set up your project and can access Analytics as
described in
Get Started with Analytics.
Set user properties
You can set Analytics user properties to describe the users of your app.
You can make use of user properties by creating custom definitions, then using
them to apply comparisons in your reports or as audience evaluation criteria.
You can access this data from the
Custom Definitions page
of Analytics in the Firebase console. The page shows a list of
user properties that you have defined for your app. You can use these properties
in comparisons on many of the reports available in Google Analytics.
Read more about the
dashboard.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-22 UTC."],[],[],null,["iOS+ Android Web Flutter \n\n\u003cbr /\u003e\n\nUser properties are attributes you define to describe segments of your\nuser base, such as language preference or geographic location. These can be used\nto define [audiences](https://support.google.com/firebase/answer/6317509)\nfor your app. This guide shows you how to set user properties in your app.\n\nAnalytics automatically logs some\n[user properties](https://support.google.com/analytics/answer/9268042); you\ndon't need to add any code to enable them. If you need to collect additional\ndata, you can set up to 25 different user properties per project. Note that user\nproperty names are case-sensitive and that setting two user properties whose\nnames differ only in case results in two distinct user properties being logged.\n\nYou can't use a small set of user property names reserved by Google:\n\n- **Age**\n- **Gender**\n- **Interest**\n\nBefore you begin\n\nMake sure that you've set up your project and can access Analytics as\ndescribed in\n[Get Started with Analytics](/docs/analytics/get-started?platform=web).\n\nSet user properties\n\nYou can set Analytics user properties to describe the users of your app.\nYou can make use of user properties by creating custom definitions, then using\nthem to apply comparisons in your reports or as audience evaluation criteria.\n\nTo set a user property, follow these steps:\n\n1. Create a custom definition for the user property in the [**Custom Definitions** page](https://console.firebase.google.com/project/_/analytics/userproperty) of *Analytics* in the Firebase console. For more information, see [Custom dimensions and metrics](https://support.google.com/analytics/answer/10075209).\n2. Set a user property in your app with the [`setUserProperty()`](/docs/reference/js/analytics#setuserproperties) method.\n\nThe following example shows how to add a hypothetical \"favorite food\" property,\nwhich assigns the value in the string `food` to the active user: \n\nWeb \n\n```javascript\nimport { getAnalytics, setUserProperties } from \"firebase/analytics\";\n\nconst analytics = getAnalytics();\nsetUserProperties(analytics, { favorite_food: 'apples' });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/analytics-next/index/analytics_set_user_properties.js#L8-L11\n```\n\nWeb \n\n```javascript\nfirebase.analytics().setUserProperties({favorite_food: 'apples'});https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/analytics/index.js#L38-L38\n```\n| **Note:** After the property is registered, it can take several hours for data collected with the property to be included in reports. When the new data is available, the user property can be used as a report filter or audience definition.\n\nYou can access this data from the\n[**Custom Definitions** page](https://console.firebase.google.com/project/_/analytics/userproperty)\nof *Analytics* in the Firebase console. The page shows a list of\nuser properties that you have defined for your app. You can use these properties\nin comparisons on many of the reports available in Google Analytics.\nRead more about the\n[dashboard](https://support.google.com/analytics/answer/11014767).\n| **Note:** Data in the Analytics reporting dashboard refreshes periodically throughout the day."]]