Built-in user attributes
Read time: 1 minute
Last edited: Jan 13, 2023
This topic explains what built-in user attributes are and how to configure them.
LaunchDarkly allows you to target users based on built-in attributes. To learn more, read Targeting rules.
All built-in user attribute values are
strings with the exception of
anonymous, which also accepts a
While LaunchDarkly provides built-in attribute fields for you to fill in, the SDK does not automatically collect any information. If you want to target your users based on any built-in attributes, you must supply their values.
The exceptions to this are the
device attributes used by mobile SDKs. Mobile SDKs automatically populate these values.
Here is a table explaining LaunchDarkly's built-in attributes:
|Attribute key||Attribute example value||Notes|
|"1f2e2d3a"||Required for evaluation. This should be unique for each user.|
|"2398127"||If provided, this attribute is used with a user's |
|"10.10.10.10"||This attribute should be a valid IP address.|
|"http://example.com/avatar.png"||This attribute must be an absolute URL to a profile picture for the user. The profile picture appears on the Users list.|
|"true"||This can be a boolean or string value. This attribute prevents the user from appearing on the list. If the anonymous attribute is set to any value other than boolean |
|25||This attribute is available only in mobile SDKs. Mobile SDKs automatically provide a value for the attribute.|
|"Pixel XL marlin"||This attribute is available only in mobile SDKs. Mobile SDKs automatically provide a value for the attribute.|
The user key is the only mandatory user attribute. All other user attributes are optional.
You can structure your user keys so they are both searchable and unique. To do this, we suggest adding a searchable term to the beginning of the key, followed by a unique ID. For example, if you wanted to easily search users that encountered a specific service, you could structure the key as follows:
You can view a user's attributes by clicking on the individual user from the Users list.