Background notifications

Background only pushes containing data for badge updates, background refreshes, or other non-visual updates can be enabled when configuring notifications.

In most cases this setting should be left disabled.

Overview

• Enable the background notifications option when configuring a push notification.
• For full background behaviour, such as refreshing data in the background, additional capabilities must be enabled in the iOS app (see below).

iOS Host app set-up

Note: The following setup is not required if your host application only needs to update the badge number.

1. In Xcode, ensure that the Background Modes capability is added in your app’s Signing and Capability tab.
2. Implement the required delegate methods to handle background notifications.

Refer to Apple's documentation Pushing background updates to your App for full configuration details. This document provides the complete steps for enabling and testing background notifications in your iOS app.

Considerations

• iOS may throttle background notifications if too many arrive in a short window. Apple’s guidelines suggest sending no more than two or three per hour. Use these notifications judiciously to ensure background updates occur without being suppressed.
• The Include count of unread cards in notification payload setting at Configuration > Notifications > Notification Badge Settings must be enabled for iOS background notifications to work.