Please login to access all of the features of the Community Site.

App Icon Badge

C15.0M6.0

On iOS, the number on your app's icon shows how many things in Rock are waiting for someone. Rock keeps it up to date on its own, even when the app is closed.

What counts

The badge is the person's count of unread notification messages in Rock.

SourceAdds to the badge whenClears when
Note mentionsSomeone @mentions the person in a note, on the web or in the appThe message is opened or marked read, or after 90 days
Connection request mentionsSomeone @mentions the person in a connection request comment or activityThe message is opened or marked read, or after 90 days
SMS conversationsAn unread text arrives on a system phone number the person monitorsThe person reads the conversation

Mentions count everywhere. A mention made on the web counts in the app too. Mentions only work on note types that allow them. If a system phone number has a mobile app set, its SMS messages count only in that app.

When it updates

From Rock. Each time one of these messages is added or removed, Rock sends a silent push with the new count to the person's devices. The person doesn't see a notification; only the number on the icon changes. This needs push notifications set up.

From the app. The app checks the count again each time it opens or comes back to the foreground, right after someone reads an SMS conversation, and when they leave chat. Expired messages are removed by the RockCleanup job, and the badge catches up the next time the app opens.

Chat

Chat isn't part of Rock's count. A chat push sets the badge to the person's unread chat count. The app puts Rock's count back the next time it opens or when the person leaves chat. So unread chats drop off the badge until the next chat push arrives.

Clearing in the app

Add the Notification Messages block to a page so people can see what's behind the number. Tapping a message marks it read and opens it: a page in the app when one matches, or the web page in the browser when one doesn't. Swiping marks a message read without opening it.

Without this block, mentions can only be cleared from the bell in Rock on the web, or by waiting 90 days.

Android

Android doesn't show Rock's count. Some launchers show a dot while the app has notifications in the tray. That's Android's own behavior.

Requirements

  • Rock 15.0 or later.
  • The person is signed in and has allowed notifications.
  • Push notifications are set up, so Rock can send the silent push that updates the badge while the app is closed.