# Device property tags Look up tag group names, IDs, valid values, and sentinels for device property tags. This page describes the [device properties](https://www.airship.com/docs/reference/glossary/#device_property) available as [tags](https://www.airship.com/docs/reference/glossary/#tag). ## Tags by device property In the table, the name is the tag group's name in the Airship dashboard, the tag group ID is its identifier in the API, valid tags are the values allowed for the group, and channels are the supported channel types for the tag. If Airship can't determine a real tag value for a device, the sentinel value applies instead. See [Unknown values](#unknown-values). The following table lists the tags available for each device property: | Tag group name | Tag group ID | Valid tags | Channels | | --- | --- | --- | --- | | Application Version | `ua_app_version` | Any sanitized string1 | App | | Background Enabled | `ua_background_enabled` | `"true"` or `"false"`2 | App | | Browser Name | `ua_browser_name` | `chrome`, `firefox`, `safari`, `opera`, or `edge` | Web | | Browser Type | `ua_browser_type` | `desktop` or `mobile` | Web | | Browser Version | `ua_browser_version` | Browser name and version, see [Browser Version](#browser-version) | Web | | Device Model | `ua_ios_model` | iOS device identifier, see [Device Model](#device-model) | App | | Device OS Version | `ua_os_version` | iOS or Android version, see [Device OS Version](#device-os-version) | App | | Email Domain | `ua_email_domain` | Email address domain, see [Email Domain](#email-domain) | Email | | Language | `ua_locale_language` | ISO 639-1 codes, see [Locale](#locale) | App, Web | | Language Country | `ua_locale_country` | ISO 3166-1 alpha-2 codes, see [Locale](#locale) | App, Web | | Location Enabled | `ua_location_enabled` | `"true"` or `"false"`2 | App | | NDC | `ua_ndc` | 2- or 3-digit numeric code, see [NDC](#ndc) | SMS | | Notification Opt-in | `ua_opt_in` | `"true"` or `"false"`2 | App | | RCS Enabled | `ua_rcs_enabled` | `"true"` or `"false"`2, see [RCS Enabled](#rcs-enabled) | SMS | | SDK Version | `ua_sdk_version` | SDK version number, see [SDK Version](#sdk-version) | App, Web | | Subdivision | `ua_subdivision` | ISO 3166-2 code, see [Subdivision](#subdivision) | SMS | | Time Zone | `timezone` | IANA time zone identifier, see [Time Zone](#time-zone) | App, Web | 1\. The Application Version tag group accepts any sanitized string. A push only reaches devices whose tag matches a real app version. 2\. When pushing to these tags via the API, you use a string that represents a boolean value, not an actual boolean. In other words, the valid tags are `"true"` and `"false"` rather than `true` and `false`. **Example of pushing a boolean tag using the API** ```json { "group": "ua_background_enabled", "tag": "true" } ``` ## Unknown values When Airship can't determine a real value for a device, the system applies the sentinel value of `Unknown` for a tag in both the dashboard and API. For example, if Airship is unable to determine a device's language settings, the `ua_locale_language` tag group gets the `Unknown` tag. To target those devices, push to the `Unknown` tag directly: ```json { "group": "ua_locale_language", "tag": "Unknown" } ``` The Time Zone tag group's sentinel is `Unknown` in the UI and `NO_TIME_ZONE` in the API. Tags with `"true"` or `"false"` values only do not have sentinel values: Background Enabled, Location Enabled, Notification Opt-in, and RCS Enabled. The Email Domain tag is omitted from a channel when not applicable, so it does not have a sentinel either. ## Browser Version The `ua_browser_version` tag combines one of the Browser Name tag values and a version number in the format `-`, such as `chrome-56` or `firefox-69`. Airship accepts any string in this format, but a push only reaches devices whose tag matches a real browser version. ## Device Model The `ua_ios_model` tag is for iOS only and uses Apple's device identifier rather than the marketing name. For example, the tag value `iPhone13,3` is iPhone 12 Pro. For Android, use the Device Model attribute `ua_device_model`. See [Default attributes](https://www.airship.com/docs/reference/data-collection/attributes/#default-attributes) in the *Attributes Reference*. ## Device OS Version The `ua_os_version` tag stores the OS version in one of these formats: - Major version: `1`, `123` - Full version: `1.2.3` - Major.minor with wildcard patch: `1.2.X` — matches any patch of that minor version ## Email Domain The `ua_email_domain` tag is the portion of the email address after the `@` symbol, such as `airship.com`. Use this tag to exclude problem domains from bulk sends for reputation management, or to target users by email provider. The tag isn't set when a user is opted in by default, such as for transactional messages. ## Locale The `ua_locale_language` and `ua_locale_country` tag values reflect the language and region settings on the device. Language tags use [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) codes, and country tags use [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes) codes. For example, a device set to English and United States has the language tag `en` and country tag `US`. These tags reflect device settings, not the user, so use locale as an approximation only. For example, an English-only speaker in the US who has their phone language set to Arabic and region set to China gets the Arabic and China tags, which is not a reliable signal of who the user is or where they are. ## NDC The `ua_ndc` tag stores the national destination code, commonly known in the US as the area code, derived from an SMS channel's [MSISDN](https://www.airship.com/docs/reference/glossary/#msisdn). The value is a 2- or 3-digit numeric string, such as `503`. The tag is country-specific and is only set when the MSISDN has a discernible code. ## RCS Enabled The `ua_rcs_enabled` tag is `true` when an SMS channel can receive RCS messages. See [RCS branded senders](https://www.airship.com/docs/developer/api-integrations/sms/rcs/). ## SDK Version The `ua_sdk_version` tag stores the version of the Airship SDK in one of these formats: - Major version: `1`, `123` - Full version: `1.2.3` - Major.minor with wildcard patch: `1.2.X` — matches any patch of that minor version ## Subdivision The `ua_subdivision` tag stores the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision code derived from the SMS channel's [MSISDN](https://www.airship.com/docs/reference/glossary/#msisdn), such as `US-OR` for Oregon, United States. ISO 3166-2 codes consist of a country code and a subdivision code separated by a hyphen. ## Time Zone The `timezone` tag uses [IANA](https://www.iana.org/time-zones) time zone identifiers, such as `America/Los_Angeles`. Airship maps unsupported time zones to the nearest supported tag.