# UserNotificationDictionary

> Dictionary of notification data used in the array of `notifications` when receiving pending or local notifications in [Titanium.App.iOS.UserNotificationCenter.getPendingNotifications](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.UserNotificationCenter.md#getPendingNotifications) and [Titanium.App.iOS.UserNotificationCenter.getDeliveredNotifications](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.UserNotificationCenter.md#getDeliveredNotifications).

- Source: https://titaniumsdk.com/docs/sdk/main/UserNotificationDictionary
- Titanium SDK version: main
- Kind: pseudo
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0

## Properties

### alertAction

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Alert button text ('Open', by default) or home text ('Press Home to unlock', by default)
type: String

### alertBody

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Alert message.

### alertLaunchImage

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Image displayed instead of `Default.png` when launching the application.

### alertSubtitle

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Subtitle of the notification.

### alertTitle

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Requires: iOS 8.2+

Title of the notification.

### badge

- Type: Number
- Platforms: Android, iPhone, iPad, macOS

Application badge value.

### category

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Category identifier of the notification.

### date

- Type: Date
- Platforms: Android, iPhone, iPad, macOS

Date and time when the notification was configured to fire.

### identifier

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0

The notification identifier.

This property is required in iOS 10+ and will fallback to a generated
UUID-string if not set. It is recommended to manage the identifier
yourself, but you can also get the generated UUID by accessing via
the "userInfo.id" field for parity with older iOS versions.

### region

- Type: Dictionary
- Platforms: Android, iPhone, iPad, macOS

Region of the notification.

The following keys are included:
  - latitude: The latitude of the region.
  - longitude: The longitude of the region.
  - radius: The radius of the region.
  - identifier: The identifier of the region.

### sound

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Path to the sound file configured to play when the notification was fired.

### timezone

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Timezone of the date when the notification was configured to fire.

### userInfo

- Type: UserInfoDictionary
- Platforms: Android, iPhone, iPad, macOS

Custom data object.

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.