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    Support

Users & Devices

OneSignal Features - All Users Page

For Developers
For Marketers

All Users Page

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 All Users or just Test Users, and allows you to adjust which columns are visible. These columns contain the variety of data attributes about your users, as follows:

Column
Description

Actions

Subscribed

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.

Platform

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

Device

What the user's device or browser is.

Sessions

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

Player ID

The unique identifier of the user's device.

Segments

Segments the user's device belongs to. By default, OneSignal adds all subscribed users to the All segment.

Tags

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

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

Rooted

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.

Deleting Users

You can individually delete user's devices by clicking 'Actions' and then clicking 'Delete'.

FAQ

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.

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.

Users & Devices

OneSignal Features - All Users Page

For Developers
For Marketers