Find Devices & Set Test Users

Audience > All Users

All Users shows a list of every device in your OneSignal App, and Data Collected by the OneSignal SDK.

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 sections:

• Details on All Users Data Columns
• Find your device
• Set Test Users
• Export Data.

---

Finding Users

There are a couple options for finding your device depending on the data you currently have.
If you know the device's player_id or external_user_id , jump to Adding as Test User.

If you know specific tags see this section finding device by tag.

Find Device in Dashboard

Open your app or site with your subscribed device. Make sure you are visiting a page of your site/app with OneSignal initialized (code actively running). 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 some data visible. Click the Displayed Columns List filter at the top-right. Some helpful data to check is:

📘

If you found your device, jump to Adding as Test User.

Find Player ID through SDK

You can also find your device's OneSignal PlayerId through the SDK by logging it to the console for your app or site.

Mobile App Devices

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

Web Desktop Device

1 Using the same browser profile 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
4 Add this code: await OneSignal.getUserId();
5 You will see your OneSignal Player Id logged to the console if you have a device record.

📘

Copy the Player Id without quotes and see Adding as Test User.

Web Mobile Device

1 Plug your Android device subscribed to the site into your computer and visit your site on the Android device.
2 On your desktop, open chrome to this url: chrome://inspect/#devices
Your mobile device should prompt you to enable USB Debugging
3 Select the inspect button

4 A new window on desktop should open to your site seen on the mobile device.
5 Make sure the site URL is correct with the OneSignal code active.
6 Click the "Console" section
7 Add this code: await OneSignal.getUserId();
8 You will see your OneSignal player ID logged to the console if you have a device record.

Copy the Player Id without quotes and see Adding as Test User.

📘

Copy the Player Id without quotes and see Adding as Test User.

Find Device by Tag

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.

---

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 Audience > Test Users

First, you need to find your device. Once you have your player_id or external_user_id, you can search for it (1), then next to the device record select Options > Add to Test Users (2).

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: