# Titanium.App.iOS.UserNotificationCategory

> A set of notification actions to associate with a notification.

- Source: https://titaniumsdk.com/docs/sdk/13.3.1/Titanium.App.iOS.UserNotificationCategory
- Titanium SDK version: 13.3.1
- Kind: proxy
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.4.0
- Extends: Titanium.Proxy
- Inheritance: Titanium.Proxy

To create a notification category, use the [Titanium.App.iOS.createUserNotificationCategory](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.md#createUserNotificationCategory) method.

A notification category represents a collection of [Titanium.App.iOS.UserNotificationAction](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.UserNotificationAction.md)
to associate with a specific notification.  The notification category allows the application to
customize the notification options based on which notification style is used.  For alert dialogs,
only four notification actions can be displayed, while all other notifications can only display two
actions.

To use a local interactive notification, you need to register the notification category using
the [Titanium.App.iOS.registerUserNotificationSettings](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.md#registerUserNotificationSettings) method and send a notification using the
[Titanium.App.iOS.scheduleLocalNotification](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.md#scheduleLocalNotification) and pass the category identifier to the `category`
property.

## Properties

### actionsForDefaultContext

- Type: Array<Titanium.App.iOS.UserNotificationAction>
- Platforms: iPhone, iPad, macOS

Array of notification actions to associate with the group.

Note that only the first four actions can be displayed for an alert dialog and on the Apple Watch.
The first two actions can be displayed for all other notifications.

### actionsForMinimalContext

- Type: Array<Titanium.App.iOS.UserNotificationAction>
- Platforms: iPhone, iPad, macOS
- Requires: iOS ≤9.3

Array of notification actions to display for non-dialog-style notification.

If not specified, the first two actions from `actionsForDefaultContent` are displayed.
Note: This property has been removed in iOS 10. iOS 10+ will handle the actions internally.

### categorySummaryFormat

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.4.0
- Requires: iOS 12+

A format string for the summary description used when the system groups the category's notifications.

### hiddenPreviewsBodyPlaceholder

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

The placeholder text to display when notification previews are disabled for the app.

### identifier

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

Identifier for this category.

When scheduling a notification, pass this value to the `category` property.

### intentIdentifiers

- Type: Array<String>
- Platforms: iPhone, iPad, macOS
- Requires: iOS 10+

The intents related to notifications of this category.

When a notification is delivered, the presence of an intent identifier
lets the system know that the notification is potentially related to the
handling of a request made through Siri.

### options

- Type: Array<Number>
- Platforms: iPhone, iPad, macOS
- Requires: iOS 10+

Options for how to handle notifications of this type.

If not specified, defaults to [Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_NONE](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.md#USER_NOTIFICATION_CATEGORY_OPTION_NONE).

Accepts: `Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_ALLOW_IN_CARPLAY`, `Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_CUSTOM_DISMISS_ACTION`, `Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_SUBTITLE`, `Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_TITLE`, `Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_NONE`

## Inherited members

1 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/13.3.1/Titanium.Proxy.md): `apiName`

---

- 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`.