iOS: Relevance score

How you can set a relevance score

1000

Image showing selection of relevance score into Morning Summary

Apple’s Relevance Score allows you to indicate the importance of each push notification or Live Activity update. This score helps iOS determine how prominently to display your notifications in the Notification Summary (for push) or Dynamic Island/Lock Screen (for Live Activities).

4000

Image. Showing user settings on an iPhone for their Daily Summary


Relevance Score for push notifications

Introduced in iOS 15, the relevance score is a value from 0.0 to 1.0 that signals to the system the importance of a notification. Notifications with higher relevance scores are shown more prominently in the user’s Notification Summary, which you can configure for scheduled delivery times.

  1. Make sure you followed our Mobile SDK setup docs for iOS that implement the Notification Service Extension. This extension allows you to customize payloads, including relevance score.

  2. When creating a Push message, under iOS options, specify the Relevance Score from 0.0 (least important) to 1.0 (most important).

    1. API parameter: ios_relevance_score

📘

Tip

Reserve a score of 1.0 for the most critical messages. Overusing high scores will cause the system to ignore the distinction, making them all blend together in summary.

Example use cases:

  • New Direct Messages set to 1.0
  • Promotional alerts set to 0.2
  • Daily reminders set to 0.6
Example setting the Relevance Score via the OneSignal dashboard.

Example setting the Relevance Score via the OneSignal dashboard.


Relevance Score for Live Activities

If your app starts multiple Live Activities, the one with the highest relevanceScore is prioritized for display in the Dynamic Island. If two or more Live Activities share the same score, the system will show the earliest-started activity. On the Lock Screen, the relevanceScore also determines the display order of your app's Live Activities.

When using our Update Live Activity API, set the ios_relevance_score to any double data type value between 0.0 and 1.0.