Set up mobile message inbox

Message Inbox (also called App Inbox, the “bell icon” screen inside your app) lets you keep the most important messages in your app by creating a dedicated section for such notifications. Messages can be delivered to the Inbox with a notification or without one. You can choose it in the settings.

Note

Read more about how Message Inbox works.

Note

To implement Message Inbox for websites (Web Inbox), please refer to the Web Message Inbox guide or the simpler Web Inbox widget if you just need a drop-in bell icon.

Setting up the inbox in your app

iOS: see Setting up Pushwoosh InboxKit iOS for the current UIKit inbox screen (card layouts, inline CTA buttons, install via SPM or CocoaPods).

Android: see Setting up Pushwoosh Inbox UI Android for the pushwoosh-inbox-ui module (rich cards, inline CTA buttons, style customization).

Cordova: see Setting up Message Inbox for Cordova for presentInboxUI, style customization, and programmatic message management.

React Native: see Setting up Message Inbox for React Native for presentInboxUI, style customization, and programmatic message management.

Flutter: see Setting up Message Inbox for Flutter for the pushwoosh_inbox package, PWInboxStyle customization, and programmatic message management.

Xamarin: see Message inbox for Xamarin (deprecated, Xamarin itself reached end of support in 2024).

Using Message Inbox in plugins with ProGuard

If your Android app uses ProGuard for code shrinking, you have to add the following rule to your proguard-rules.pro:

#INBOX
-keep public class com.pushwoosh.inbox.PushwooshInboxPlugin {
 *;
}

Unread messages badge

Note

This is an in-app badge, for example on your own Inbox icon inside the app’s UI. Neither method touches the app icon badge. No Pushwoosh SDK ties the unread count to the app icon, so if you want it to show there too, your app code needs to set it explicitly.

To display the number of unread messages on a badge over an Inbox icon, please use the following API methods:

iOS

[PWInbox unreadMessagesCountWithCompletion:^(NSInteger count, NSError *error) { }];

Android

PushwooshInbox.unreadMessagesCount(result -> { });