Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

The dashboard gives you two levels of detail for inspecting audience members: the User Profile and the Subscription Profile. Use the User Profile to see a complete picture of a user across all their channels and devices. Use the Subscription Profile to inspect a single messaging channel, for example a push or email subscription.

User Profile

You can open a User Profile in two ways:
  • From Audience > Users, search by External ID, email address, phone number, or OneSignal ID, then click the record.
  • From Audience > Subscriptions, click the OneSignal ID on a subscription record directly, or use the menu option on the record, select View subscription, then click the OneSignal ID.
The profile header shows the user’s External ID, email address, OneSignal ID, and their current subscription status across channels.

Overview tab

The Overview tab is a summary of the user’s identity and recent activity. Profile section
FieldDescription
External IDYour system’s unique identifier for this user.
OneSignal IDOneSignal’s internal UUID for this user record.
EmailEmail address associated with the user.
PhonePhone number associated with the user, if any.
CountryCountry detected or set for this user.
LanguageLanguage preference.
TimezoneTimezone associated with the user.
Location PointGeographic coordinates, if location data has been collected.
Devices section Lists all devices associated with this user, such as an iOS or Android device. Aliases section Any additional aliases (beyond External ID and OneSignal ID) that have been associated with this user record. Activity section Shows aggregate session data across all of the user’s subscriptions:
FieldDescription
First activeWhen the user was first seen.
Last activeMost recent session.
Total sessionsTotal session count.
Total session durationCumulative in-app time.
Message events in last 30 days shows a summary of recent message interactions across all channels.

Event log tab

The Event log shows message events and custom events for this user across all subscriptions. Use the date range picker and message type filter to narrow results. Toggle between Message events and Custom events using the sidebar tabs.
Message events include sends, deliveries, opens, and clicks. Custom events are logged via the SDK or API and reflect actions you define in your app.

Subscriptions tab

The Subscriptions tab lists every channel subscription associated with this user, including push, email, and SMS. Each subscription shows:
  • Channel type and address (email address, push device, phone number)
  • Subscription status
  • Subscription ID
  • Created at and last active timestamps
  • For push: device, app version, usage duration, sessions, IP address, SDK version, and push token
Click a Subscription ID to open the full Subscription Profile for that record.

Data tags tab

The Data tags tab shows all tags currently set on this user. Tags are key-value pairs you use for segmentation and personalization. You can search tags by key or value, and add new tags directly from this view using the Add tag button.
Tags edited here are applied at the user level and are shared across all of this user’s subscriptions. Tag values are always strings.

Journeys tab

The Journeys tab shows all Journeys this user is currently enrolled in or has previously exited. Each row shows the Journey name and the user’s current status: Active or Exited.

Subscription Profile

You can reach a Subscription Profile in two ways:
  • From Audience > Subscriptions, search for the subscription directly
  • From a User Profile’s Subscriptions tab, click the Subscription ID
The profile header shows the Subscription ID and its current status, for example Subscribed.

Profile section

The Profile section shows channel-specific metadata for this subscription. For push subscriptions:
FieldDescription
DeviceDevice model and OS version.
Status detailsAdditional status context, if available.
OneSignal IDThe OneSignal ID of the user this subscription belongs to.
External IDYour system’s identifier for the associated user.
LanguageLanguage setting on the device.
TimezoneDevice timezone.
Last SessionTime of the most recent app session.
First SessionTime of the first recorded session.
SessionsTotal session count.
Usage DurationCumulative time spent in the app.
SDK VersionVersion of the OneSignal SDK installed on the device.
App VersionVersion of your app installed on the device.
For email subscriptions:
FieldDescription
ChannelEmail.
EmailThe email address for this subscription.
Status detailsAdditional status context, if available.
OneSignal IDThe OneSignal ID of the associated user.
External IDYour system’s identifier for the associated user.
LanguageLanguage preference.
Last SessionMost recent session.
First SessionFirst recorded session.
SessionsTotal session count.
Usage DurationCumulative session time.

User Tags

The User Tags section on the Subscription Profile shows the tags currently set on the associated user. The tag count in the section header reflects the total number of tags on the user, not just those relevant to this subscription. Click Edit in User Profile to navigate directly to the Data tags tab on the User Profile, where you can add, edit, or remove tags.

Segments

Lists all segments this subscription currently qualifies for, based on the user’s tags, behavior, and other filters. Each segment name is a link to the segment in Audience > Segments.

Journeys Audience

Lists the Journeys this user has entered. A Journey remains listed even if the user exited early, as long as they still meet the Journey’s entry criteria. It is removed from this list only when the user no longer qualifies for that Journey.

Message Activity Timeline

The right side of the Subscription Profile shows a timeline of message events for this specific subscription, including sends, deliveries, opens, and clicks, within the selected date range. Use the date range picker to adjust the window. If there is no recent activity, the timeline displays “No Recent Activity.”
The Message Activity Timeline on a Subscription Profile is scoped to that subscription only. To see activity across all of a user’s subscriptions, use the Event log tab on the User Profile.

Users

The OneSignal user model, aliases, and how users relate to subscriptions.

Subscriptions

Devices, email addresses, and phone numbers that receive your messages.

Segments

Build audience segments based on tags, behavior, and subscription data.

Data Tags

Add custom properties to users for personalization and segmentation.

Journeys

Automate multi-step messaging workflows across channels.