Notification Grouping

iOS Notification Grouping

Apple started supporting notification grouping in iOS 12.

Use the thread_id REST API property with the same value to group messages together.

Android Notification Grouping

Use the android_group REST API property with the same value to group messages together.

Android "Group Key" can also be set when sending push messages from the dashboard.


Android 7+ Default behavior

  • Automatically groups your notifications after the device has 4 or more visible notifications for your app, even if you don't set a group key.
  • Automatically generates the text for the summary notification for the grouped notifications.
    The custom group message only shows on Android 6.0 (Marshmallow) devices and older.

If you need more customizations see the Android NotificationExtenderService to group messages and add another NotificationExtenderService to update the summary notification. See Android's Group Notify Guide for more details.

Note there are some limitations that Android 7+ has for these summary notifications. You can only modify the text, accent color and small icon (not large icon). However, you can still modify the children.


  • Also works on Amazon devices, set the group key listed under the amazon settings as well.

Group Message

Only applies to Android 6.0 and lower. Display a group summary notification that appears alone. By default '# new messages' will show on the device when 2 or more notifications are received with the same group key. Enter a custom message with '$[notif_count]' in the message text so the count can be replaced.