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

All Users

OneSignal features - View All Users page

Dashboard > Users > All Users

The All Users page shows a list of every user's device in your app, and data attributes about each. To view all the data attributes, you may need to scroll the browser window to the right.

The All Users page allows filtering by Segments or by individual device IDs, and allows you to adjust which columns are visible. These columns contain the variety of data attributes about your users, as follows:




Whether the user's device is currently subscribed to push notifications.

Last Active

The last date/time the user's device communicated with OneSignal servers.

For Web Push: This value is updated anytime a user visits any OneSignal-enabled page of your site in a new tab or new window. Clicking links in the same page or refreshing the same page does not cause the value to be updated for performance reasons. If a user clicks a notification and the notification brings them back to a OneSignal-enabled page of your site in a new tab, the Last Active time will be updated.

First Session

The first date/time the user's device communicated with OneSignal servers.


Specific model of the user's device, including operating system version.


What the user's device or browser is.


Number of unique times the user's device has communicated with OneSignal servers.

Player ID

The unique identifier of the user's device. More info on the OneSignal Player ID


Segments the user's device belongs to.


The JSON output of any tags your app has added to the user.

App Version

The version of your app the device was running the last time it communicated with OneSignal servers.


Country the user's device was in the last time it communicated with OneSignal servers.


Android - whether the device is rooted.

Location Point

Geolocation (lat, long) of the user's device, sent if the user has granted location permissions to your app.

Usage Duration

Number of seconds the user's device has had your app open.

Finding Users

Coming Soon - You can search for email addresses in All Users to learn more about their activity.

Currently you can filter devices by Segments and Player ID.

Deleting Users

You can individually delete user's devices by clicking 'Options' and then clicking 'Delete'.
OneSignal does not provide a way to delete multiple users at this time.

Import & Export Users

For more on importing devices please see Add Users & Devices.

For exporting devices, see Exporting Data.

Unsubscribing Users

Coming Soon - Every email comes with an unsubscribe link that lets users unsubscribe themselves from your emails. You generally won't need to think about managing your unsubscribed users, as this process happens automatically. If, however, you need to manually unsubscribe a particular user, you can do so by going to All Users and searching for the email address of the user you wish to unsubscribe. When you see the user record you want to unsubscribe, click 'Options' and 'Unsubscribe from email' in the menu:


For Developers

How do I delete several unsubscribed users from the All Users Page?

Presently there is no way to bulk clear unsubscribed users, however you may individually delete users. We keep unsubscribed users around for a few reasons:

  1. Users who are unsubscribed may later re-subscribe to notifications. Keeping this user data around allows our system to continue accurately tracking metrics such as session count, usage duration, and tags.

  2. Our automatic notifications feature is designed to avoid delivering the same notification twice to users who have previously received it. Deleting users could interfere with this mechanism.

  3. Clients often want to see data about unsubscribed users through our dashboard or API.

  4. Deleting users who currently have your app installed may cause unexpected behavior when using certain OneSignal methods in your app, such as SendTags.

In general we recommend not deleting users except if the device was not configured correctly during development.

What does the Subscribed column on the All Users dashboard page mean?

For your specific app, a subscribed user is eligible to receive your app's push notifications. The user has opted to receive push notifications and has a valid push token.

For an unsubscribed user, one or more of the following is true:

  • The user did not accept the notification permission prompt.
  • There was an error subscribing to Apple or Google for push.
  • The SDK function setSubscription was called with false.
  • The user uninstalled the app (for mobile) or cleared their browser data (for web).

When does the OneSignal User / Player ID change?

It will stay the same as long as the user has your app installed or for web push as long as the user does not clear their browser data for your site. If the user hasn't opted out of the Google Ad id (Android) the ID will stay the same after full re-installs. On iOS, the IFV (Identifier For Vendor) is used to keep the ID the same after a full re-install, but only if the user has another one of your apps installed. Please see our section on the OneSignal Player ID for more.

Can I track users that have uninstalled my app?

Yes and no. Mobile operating system providers make it intentionally difficult to reliability detect when a user has uninstalled an app.

OneSignal does detect the approximate time when a device stopped receiving notifications, and our API can be used for your system to be notified of this. This generally occurs once a device uninstalls your app, but it can also happen if the user disables notifications for your app.

All Users

OneSignal features - View All Users page

Suggested Edits are limited on API Reference Pages

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