Email message reports help you track the performance of each email, including delivery stats, open rate, click rate, and error diagnostics. When viewing an email report in OneSignal, you’ll see real-time statistics showing how your message is performing.

Snapshot view of real-time email message data

Messages sent via the API are retained for ~30 days. To retain historical performance, export data using the Dashboard or API. See Exporting Data.

Delivery statistics

Delivered

Understand how many recipients received your message, and why others didn’t.

NameDescription
AudienceNumber of email subscriptions in the audience at send time.
SentSubscriptions in the audience minus those remaining, bounced, failed, or suppressed.
DeliveredEmails confirmed as delivered to recipients’ inboxes.
RemainingEmails still queued for sending.
BouncedMessages rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. These addresses are added to the Suppression List.
FailedEmails dropped by OneSignal and never sent. See Why are emails marked as failed?.
Tip: Export failure details in Audience Activity.
SuppressedEmails blocked due to prior bounces or spam reports. Suppression protects your sender reputation. Only applies to OneSignal Email.

Open rate

Open events are counted when the email is viewed, though privacy settings and inbox behavior may affect accuracy. See Why are open events low?.

NameDescription
Unique OpensCount of individual recipients who opened the email.
Total OpensTotal number of times the email was opened, including repeats.

Click-through rate

Measure engagement through link clicks in your email.

NameDescription
Click-Through Rate (CTR)(Unique Clicks / Delivered) * 100%. Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled.
Total ClicksAll link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links.
Click to Open Rate (CTOR)(Unique Clicks / Unique Opens) * 100%. Measures how engaging the email was after being opened.

CTR vs CTOR

  • CTR: Clicks as a % of deliveries
  • CTOR: Clicks as a % of opens
  • Use both to evaluate message quality and engagement.

Tip: Use UTM parameters for tracking in tools like Google Analytics.

If Click Tracking is enabled but click events are low, check for browser-level blocking (e.g., Brave or Firefox). Contact support@onesignal.com if the issue persists.

Unsubscribed and reported as spam

Understand opt-outs and spam complaints so you can improve targeting and deliverability.

NameDescription
UnsubscribesNumber of recipients who opted out of receiving emails. Status is updated immediately.
Reported as SpamRecipients who marked your message as spam. These addresses are automatically added to the Suppression List.

Use segmentation and send-time optimization to lower unsubscribe and spam rates.

Keep an eye on your unsubscribe and spam rates. If they’re too high, your app may get disabled until the issue is addressed. See:


Message statistics

Analyze performance trends over time, including engagement and delivery issues.

Message Statistics over 24-hour view

View metrics by:

  • 30 days (default)
  • 24 hours
  • 60 minutes

You can toggle additional metrics like Bounced, ESP Failed, Sent, Spam, Suppressed, Total Clicks, and Total Opens.

Use the export icon in the top-right of the graph to download the data.


Audience activity

See detailed activity per recipient, including delivery, opens, clicks, unsubscribes, failures, and spam reports. Timestamps reflect the most recent event for each user.

Data is retained for 30 days.

What you can do:

  • Export: Download full recipient-level data, including failure reasons.
  • Retarget: Send follow-ups to engaged (or unengaged) users. See Retargeting Messages.

Click activity

Track which links were clicked and how many times.

NameDescription
Unique ClicksCount of links clicked by recipients.
Total ClicksAll link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links.
Click-Through Rate (CTR)(Unique Clicks / Delivered) * 100%. Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled.

FAQ

Why are my emails marked as failed?

Failure reasons are shown in the Audience Activity export. Common causes include:

Why are open events low?

  • Inbox privacy features (e.g., Apple Mail Privacy Protection)
  • Ad blockers or security software
  • Image tracking being blocked

Open tracking is not always 100% reliable. Test on multiple devices and networks for comparison.

Why do I see emails in Pending?

Two main reasons:

  1. Scheduled delivery: Especially if auto warm-up is enabled, delivery is spread out.
  2. Pending confirmation: Some inboxes delay event feedback up to 8 hours.

If the message stays in Pending, it’s likely sent but not confirmed. Check Sent at in Audience Activity for clues.


Email message reports help you track the performance of each email, including delivery stats, open rate, click rate, and error diagnostics. When viewing an email report in OneSignal, you’ll see real-time statistics showing how your message is performing.

Snapshot view of real-time email message data

Messages sent via the API are retained for ~30 days. To retain historical performance, export data using the Dashboard or API. See Exporting Data.

Delivery statistics

Delivered

Understand how many recipients received your message, and why others didn’t.

NameDescription
AudienceNumber of email subscriptions in the audience at send time.
SentSubscriptions in the audience minus those remaining, bounced, failed, or suppressed.
DeliveredEmails confirmed as delivered to recipients’ inboxes.
RemainingEmails still queued for sending.
BouncedMessages rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. These addresses are added to the Suppression List.
FailedEmails dropped by OneSignal and never sent. See Why are emails marked as failed?.
Tip: Export failure details in Audience Activity.
SuppressedEmails blocked due to prior bounces or spam reports. Suppression protects your sender reputation. Only applies to OneSignal Email.

Open rate

Open events are counted when the email is viewed, though privacy settings and inbox behavior may affect accuracy. See Why are open events low?.

NameDescription
Unique OpensCount of individual recipients who opened the email.
Total OpensTotal number of times the email was opened, including repeats.

Click-through rate

Measure engagement through link clicks in your email.

NameDescription
Click-Through Rate (CTR)(Unique Clicks / Delivered) * 100%. Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled.
Total ClicksAll link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links.
Click to Open Rate (CTOR)(Unique Clicks / Unique Opens) * 100%. Measures how engaging the email was after being opened.

CTR vs CTOR

  • CTR: Clicks as a % of deliveries
  • CTOR: Clicks as a % of opens
  • Use both to evaluate message quality and engagement.

Tip: Use UTM parameters for tracking in tools like Google Analytics.

If Click Tracking is enabled but click events are low, check for browser-level blocking (e.g., Brave or Firefox). Contact support@onesignal.com if the issue persists.

Unsubscribed and reported as spam

Understand opt-outs and spam complaints so you can improve targeting and deliverability.

NameDescription
UnsubscribesNumber of recipients who opted out of receiving emails. Status is updated immediately.
Reported as SpamRecipients who marked your message as spam. These addresses are automatically added to the Suppression List.

Use segmentation and send-time optimization to lower unsubscribe and spam rates.

Keep an eye on your unsubscribe and spam rates. If they’re too high, your app may get disabled until the issue is addressed. See:


Message statistics

Analyze performance trends over time, including engagement and delivery issues.

Message Statistics over 24-hour view

View metrics by:

  • 30 days (default)
  • 24 hours
  • 60 minutes

You can toggle additional metrics like Bounced, ESP Failed, Sent, Spam, Suppressed, Total Clicks, and Total Opens.

Use the export icon in the top-right of the graph to download the data.


Audience activity

See detailed activity per recipient, including delivery, opens, clicks, unsubscribes, failures, and spam reports. Timestamps reflect the most recent event for each user.

Data is retained for 30 days.

What you can do:

  • Export: Download full recipient-level data, including failure reasons.
  • Retarget: Send follow-ups to engaged (or unengaged) users. See Retargeting Messages.

Click activity

Track which links were clicked and how many times.

NameDescription
Unique ClicksCount of links clicked by recipients.
Total ClicksAll link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links.
Click-Through Rate (CTR)(Unique Clicks / Delivered) * 100%. Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled.

FAQ

Why are my emails marked as failed?

Failure reasons are shown in the Audience Activity export. Common causes include:

Why are open events low?

  • Inbox privacy features (e.g., Apple Mail Privacy Protection)
  • Ad blockers or security software
  • Image tracking being blocked

Open tracking is not always 100% reliable. Test on multiple devices and networks for comparison.

Why do I see emails in Pending?

Two main reasons:

  1. Scheduled delivery: Especially if auto warm-up is enabled, delivery is spread out.
  2. Pending confirmation: Some inboxes delay event feedback up to 8 hours.

If the message stays in Pending, it’s likely sent but not confirmed. Check Sent at in Audience Activity for clues.