Setting up badges

Note

To set badges for Cordova or React Native plugins, please refer to the corresponding guides:

• Badges for Cordova
• Badges for React Native

Starting with version 6.4.0 of Pushwoosh iOS SDK, the process of managing and setting badges through push notifications has changed.

If you were previously using the badges number to indicate the number of received push notifications in your application, you have to migrate to newer version of iOS SDK (6.4.0 or later). The older versions will be supported until the end of the second quarter of 2022.

How to set up badges

To set up badges, follow the steps below:

1. Add Notification Service Extension (File -> New -> Target…)

2. Select the “Notification Service Extension”

3. Copy the code from the code block and add it to your project as shown in the pictures below:

Swift

PWNotificationExtensionManager.shared().handle(request, contentHandler: contentHandler)

Objective-C

[[PWNotificationExtensionManager sharedManager] handleNotificationRequest:request contentHandler:contentHandler];

Note

If you had integrated Delivery Message Tracking, you could have skipped steps below (steps 4, 5, 6).

4. Add the App Groups capability for each target of your application

5. Add the App Groups ID

Add the App Groups ID to your info.plist for each target of your application:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

If you do not want to use the info.plist file, use the method below and add the code to your NotificationServiceExtension class:

Swift

PWNotificationExtensionManager.shared().handle(request, withAppGroups: "group.com.example.demoapp_example")

Objective-C

[[PWNotificationExtensionManager sharedManager] handleNotificationRequest:request withAppGroups:@"group.com.example.demoapp_example"];

Example

Send a push notification with badges

If you want to send push notification with badges from Pushwoosh Control Panel, just add a desired badge value to the badges text field as shown in the picture below:

Note

You can use the following value formats to send badges correctly: +1, -1 or 5. If you want to increment badge value, use ”+” sign**,** if you want to decrement badges, use ”-” sign**.** You can also set the exact number by using e.g. 5 with no sign.

Share your feedback with us

Your feedback helps us create a better experience, so we would love to hear from you if you have any issues during the SDK integration process. If you face any difficulties, please do not hesitate to share your thoughts with us via this form.