OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions


OneSignal features - App overview

The OneSignal Dashboard is the primary user interface for working with OneSignal. The dashboard exposes all the functionality of OneSignal in an easy-to-use interface for developers and marketers alike.

The main pages of the dashboard are:


The application's dashboard is accessible by clicking on one of your applications. This page shows your total and subscribed userbase, as well as introduces you to OneSignal features.

What are Users?

Users are measured as devices on mobile apps, browser profiles on web that have subscribed to your site at some point and email addresses.

Subscribed Users

A count of devices that have opted-into and can receive your messages. The number of subscribed users may decrease after sending messages, because sending messages is one of the methods used to detect unsubscribed users and users who have uninstalled your app.

Monthly Active Users

An estimate of the number of users who have used you app in the last 30 days. Examples of activity include opening a notification, opening the app, receiving tags from the app.

Devices that receive notifications or tag updates from the API but are otherwise inactive are not included in this count.

Total Users

Total is the number of subscribed and unsubscribed device records that have interacted with our SDK on your app or website. It also contains user records uploaded to your account via our dashboard or API. This number never goes down.

For mobile apps, a device must download and open the app with our SDK to be included. If a device uninstalls and re-installs the app, this may give the user a new player id record. Total Users will increase in this case, but subscribed users will not. More details in our Player ID docs.

For web, if users clear browser cache and return to the site, they will likely get resubscribed (HTTPS sites only) and this will increase Total Users while Subscribed Users stays constant. More details in our Player ID docs.


The revoked metric shows how many subscribed devices have turned off push but continue to use the app or website. The OneSignal SDK must detect the device for revoked to be updated.

Revoked will go up and down depending on if the user unsubscribes and then re-subscribes.



Revoked counts subscribed devices that unsubscribe through the App Settings or through the OneSignal setSubscription method.

Devices that uninstalled the app or unsubscribed without returning to the app will not be counted as revoked but will be detected as unsubscribed when sending them push. More details on Managing Users In OneSignal.


Revoked only counts web push subscribers that unsubscribe through the Bell Prompt, Custom Link prompt or with the OneSignal setSubscription method.

Users that unsubscribe through the browser settings or clear browser data will be detected as unsubscribed when sending them push. More details on Managing Users In OneSignal.

Tracking Revoked

Using the OneSignal Subscription Change Event Methods you can capture when devices unsubscribe and send the device id to your analytics. More details in Analytics Integrations





Sent Messages - where you can see messages you've sent
Message Report - the realtime results of your sent message

Updated 2 months ago


OneSignal features - App overview

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.