Last modified October 17, 2024 by Shelly Wolfe

Swrve user properties

User properties specify the current state of the user. You can use both default and custom properties for tracking and targeting of in-app messages, embedded experiences, and push notifications.

Assign user properties to easily segment your user base and send the status of the user. For example, use the swrve.device_region user property to target users in a certain country, or create a custom user property called premium, and then target non-premium users and premium users.


Default user properties

Some user properties are automatically sent to Swrve at initialization. Default Swrve user properties include, but are not limited to:

Property Description
swrve.os The operating system of the device. (iPhone OS, Android…)
swrve.os_version The operating system version. (iOS 16.0.3, Android 13.0.0…)
swrve.language The language of the device.
swrve.sdk_version The Swrve SDK being used.
swrve.device_dpi The dots per inch of the device.
swrve.device_name The name of the device.
swrve.device_width The width of the device in pixels.
swrve.device_height The height of the device in pixels.
swrve.sim_operator.name The mobile operator of the registered SIM card. Deprecated in iOS 16+.
swrve.sim_operator.iso_country_code The 2-letter ISO country code of the mobile operator. Deprecated in iOS 16+.
swrve.sim_operator.code The unique number assigned to every mobile operator in all countries of the world. Deprecated in iOS 16+.
swrve.device_region The 2-letter ISO country code of the selected region of the device.
swrve.timezone_name The timezone name for the user taken from the device.
swrve.install_date Integer value generated on device when the app is first run – format yyyymmdd.
iOS only 
swrve.permission.ios.photos The user’s photo permission status. Possible string values are unknown, unsupported, denied or authorized.
swrve.permission.ios.push_notifications The user’s push notifications permission status. Possible string values are unknown, unsupported, denied or authorized.
Swrve.permission.ios.contacts The user’s contacts permission status. Possible string values are unknown, unsupported, denied or authorized.
Swrve.permission.ios.location.when_in_use The user’s location (when in use) permission status. Possible string values are unknown, unsupported, denied or authorized.
Swrve.permission.ios.location.always The user’s location (when in use) permission status. Possible string values are unknown, unsupported, denied or authorized.
Swrve.permission.ios.camera The user’s camera permission status. Possible string values are unknown, unsupported, denied or authorized.
Android only (Android SDK version 10.4.0, Unity SDK version 9.0.0 or higher)
swrve.permission.android.notification The user’s notification permission status. Possible string values are denied or granted. User property is only set for devices on Android 13 or higher.
swrve.permission.android.notification_show_rationale Indicates whether the permission dialog was previously shown. Returns true if the permission dialog was shown once and the user denied it (not dismissed). Returns false if permission dialog was never shown, or if it was shown but the user dismissed it without granting or denying it, or was shown/responded to twice, or if permission was already granted.

User property is only set for devices on Android 13 or higher.

swrve.permission.android.notification_answered_times The number of times the user has answered the permission request. A dismissal is not counted—the user must respond by granting or denying permission. Possible integer values are 0, 1, or 2.
swrve.os_int_version The OS API Level installed on the device. Corresponds to swrve.os_version, but an integer.
swrve.app_target_version The app’s target Android API Level.

For a more extensive list of default user properties sent from your app, see the Swrve User Properties file in your User DB Downloads.


Custom user properties

Create custom user properties to segment your users and learn more about their status in your app. For more information on creating custom user properties, see the relevant SDK integration guide: