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 Subscription Trends charts on the OneSignal dashboard show how Subscriptions — each device or channel a user can receive messages on — subscribe and unsubscribe over time, broken down by channel. Subscription Trends track opt-in and opt-out activity. They do not track message engagement like opens or clicks. Use Engagement Trends for that. Navigate to Dashboard > Analytics > Subscription Trends to view these charts.

Charts

Subscription Trends presents two charts.

Total subscribed

The Total subscribed chart shows the cumulative count of Subscriptions that can currently receive messages. The headline number reflects the latest value in the selected time range, not a sum across the period.
Total subscribed chart showing cumulative subscribed count over time
MetricDescription
Total subscribedThe count of all subscribed Subscriptions. Counts will fluctuate as users install and uninstall your app, clear browser data, subscribe and unsubscribe to your messages, or get deleted. For details on how these events are tracked, see Subscriptions.

Subscription status changes

The Subscription Status Changes chart tracks opt-in and opt-out activity using two tabs. Select a tab to view subscribes or unsubscribes independently.
The Subscription Status Changes chart requires a paid plan. Free plan accounts see an upsell prompt in place of the chart.
Subscription Status Changes chart with Subscribes and Unsubscribes tabs
TabDescription
SubscribesThe count of subscription status changes from unsubscribed to subscribed. This includes newly created subscribed Subscriptions and current Subscriptions that subscribed to messages in the selected timeframe.
UnsubscribesThe count of subscription status changes from subscribed to unsubscribed. This does not include newly created Subscriptions that never subscribed or denied the push prompt.

What to track

Use Subscription Trends to monitor:
  • Growth or decline in your subscribed audience over time
  • The impact of permission prompts on new subscribes
  • Unsubscribe spikes following campaigns

FAQ

What is a Subscription?

A Subscription represents a single device or channel through which a user can receive messages — for example, a push token for a mobile device, an email address, or a phone number for SMS. A single user can have multiple Subscriptions. See Subscriptions for the full definition.

Why does my Total subscribed count fluctuate?

Total subscribed reflects the live count of subscribed Subscriptions. It changes as users install or uninstall your app, clear browser data, subscribe or unsubscribe from messages, or get deleted from the system. See Subscriptions for how these lifecycle events are tracked.

Does Unsubscribes include users who denied the push prompt?

No. Unsubscribes counts status changes from subscribed to unsubscribed. Users who deny the push prompt are never subscribed, so they are not counted here.

Subscriptions

Learn how Subscriptions are created, stored, and marked as subscribed or unsubscribed.

Engagement trends

Track message sends, opens, clicks, and unsubscribes over time.

Analytics overview

Tour the dashboards, APIs, and export tools OneSignal provides for measuring performance.

Users

Users can have multiple Subscriptions and are identified by their External ID.