---
title: Categories
description: Create categories on a device and assign notifications.
---

Notifications can be categorized into groups, allowing you to control how the system displays them. Categories also
provide the ability to display [Quick Actions](/react-native/ios/interaction#quick-actions).

Before assigning a notification to a category, it must first be created.

At minimum, a category must be created with a unique identifier using the `setNotificationCategories`
method, one of more categories will be set on the device. All categories must be set at once with this method as it
overrides any pre-existing categories on the device.

```js
import notifee from 'react-native-notify-kit';

async function setCategories() {
  await notifee.setNotificationCategories([
    {
      id: 'post',
      actions: [
        {
          id: 'like',
          title: 'Like Post',
        },
        {
          id: 'dislike',
          title: 'Dislike Post',
        },
      ],
    },
  ]);
}
```

To view more about the `actions` property, view the [Quick Actions](/react-native/ios/interaction#quick-actions)
documentation.

For call-related intent identifiers, use `IOSIntentIdentifier.START_CALL`. The legacy `START_AUDIO_CALL` and
`START_VIDEO_CALL` values are kept for compatibility but map to Apple's unified call intent identifier, and
`getNotificationCategories()` may return `START_CALL` when reading categories back from iOS.

> It is also possible to group notifications via [threadId](/react-native/reference/notificationios#threadid).

## Assigning a category

Once created, a notification can then be displayed using the `categoryId` identifier on the notification. For example,
using the `post` category:

```js
import notifee from 'react-native-notify-kit';

notifee.displayNotification({
  title: 'New post from John',
  body: 'Hey everyone! Check out my new blog post on my website.',
  ios: {
    categoryId: 'post',
  },
});
```

When displayed, the notification will be assigned to the category, and will contain the actions:

<Vimeo id="402244609" caption="iOS Category Actions Example" />

## Category summary text

After a number of unread notifications have been delivered to the device, iOS will begin to stack notifications for your
application. The notification on the top of the stack by default will display summary text, letting the user know how many
unread notifications are available:

![Default summary text](https://images.prismic.io/invertase/8d3cc19e-5cb9-41a4-9c55-1d03c975043e_ios-summary-text-default.png?auto=format)

This functionality is only available on iOS >= 12.

If required, you can override the default summary text using the `summaryFormat` property. This string accepts values
which the system replaces with variable arguments:

- `%u`: the notification count (the system handles this automatically).
- `%@`: a legacy custom argument placeholder.

The legacy `summaryArgument` and `summaryArgumentCount` notification fields are kept for compatibility, but they are
no-ops on supported iOS versions because Apple ignores notification summary arguments on iOS 15+. They may be removed in a
future major release. Prefer summary text that does not depend on `%@`.

For example:

```js
import notifee from 'react-native-notify-kit';

await notifee.setNotificationCategories([
  {
    id: 'post',
    summaryFormat: 'You have %u+ unread messages.',
    actions: [
      {
        id: 'reply',
        title: 'Reply',
      },
    ],
  },
]);

notifee.displayNotification({
  title: 'New post from John',
  body: 'Hey everyone! Check out my new blog post on my website.',
  ios: {
    categoryId: 'post',
  },
});
```

## Category Actions

To learn more about creating actions, view the [Quick Actions](/react-native/ios/interaction#quick-actions) documentation.