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

Find Devices & Set Test Users

OneSignal Dashboard - All Users Page: Finding Users, Setting Test Users, Sorting Devices and Deleting Users.

Dashboard > Audience > All Users

All Users shows a list of every device in your OneSignal App, and Data Collected by the OneSignal SDK. Use this page to do the following actions:

You can show/hide the data attributes with the columns button (1), search by Player Id, External User Id or Email (2) and filter by Segments (3).

Jump to details on All Users Data Columns below.


Finding Users

There are a couple options for finding your device depending on the data you currently have:

Find Device in Dashboard Without Player Id or External User Id

Open your app or site with your subscribed device. Make sure the OneSignal SDK is initialized. Then in All Users sort by "Last Active" so the arrow points up to see the latest active devices.

You may need to confirm it is your device by making the IP Address field visible. Click the "VISIBLE COLUMN LIST" filter at the top-right and checking IP Address to view the IP Address column.

You can also check the "DEVICE" column to see the model and Operating System version.

iOS users, the model is based on the Hardware String. Click that link and search for the device you see. For example "iPhone9,3 (12.3.1)" means "iPhone 7 with operating system version 12.3.1".

Find Device by External User Id, IP Address, Tag or Email

If you setup your app or website to collect External User Ids or if you are searching for an Email record, you can use the drop down search by the parameter.

If you added a specific tag to the user like a user_name, email tag, or other identifier, you can create a Segment with the User Tag filter to find your specific device.

To find device by IP Address, you need to get a CSV export of your devices and search them manually. Please see our guide on exporting user data from the Dashboard or use the API CSV Export POST call.

Find Player ID by SDK

You can also find your playerId through the SDK by using one of our Player Id methods in the console for your app or site.

Mobile SDK - Use the getPermissionSubscriptionState method on our Mobile SDKs to log the player id to your IDE (Xcode, Android Studio, etc.)

Web SDK:
1 Using the same browser you are subscribed to your site, open the site URL with the OneSignal code active.
2 Open the Debugger console (F12 or Right Click the site > Inspect).
3 Click the "Console" section and add this code: await OneSignal.getUserId();
4 You will see your OneSignal player ID logged to the console if you are subscribed.


Test Users

Test Users are a special group of devices that you can manually manage in order to test delivery of messages. Any user record may be added to the Test Device list in Dashboard > Audience > Test Users

First you need to find your devices, then simply select Options > Add to Test Users

Next you can Segment Users by Test Users Filter and/or send messages using the Send To Test Device Button.


All Users Data Columns

The provided columns contain a variety of data attributes about your users, as follows:

Column
Description

Actions

Channel

Push or Email Record

Subscribed

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

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.

Device

Platform and specific model of the user's device, including operating system version or browser version.

Sessions

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

App Version

Xcode build number or Android Studio versionCode in your App build.gradle

Country

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

IP Address

By default this is not collected for EU Users. More details in Handling Personal Data.

SDK Version

OneSignal SDK Version based on the Native SDK Platform

Rooted

Android - whether the device is rooted.

Location Point

Mobile Only - Geolocation (lat, long) of the user's device, sent if the user has granted location permissions to your app. Must be turned on to be tracked More details in Handling Personal Data.

Usage Duration

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

Language Code

The language set in the device or browser settings.

Player ID

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

External User ID

Your unique user id. See Internal Database, DMP, & CRM.

Segments

Segments the user's device belongs to.

Tags

The JSON output of any tags your app has added to the user. More details in Add Data Tags.

Email

- The email address of the device. More in Email Overview.

Push Token

The identifier of the device that facilitates push notifications. Must be available to receive push.

Updated 2 days ago


Find Devices & Set Test Users


OneSignal Dashboard - All Users Page: Finding Users, Setting Test Users, Sorting Devices and Deleting Users.

Suggested Edits are limited on API Reference Pages

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