Email Message Reports

OneSignal Email delivery and statistics

When clicking an email report, you will see the high-level stats of how the message is currently performing. For exporting data, see Export Message Data.


Image showing snapshot view of realtime message data


AudienceThe number of email addresses included in the audience at the time of sending.
DeliveredThe number of messages confirmed to be successfully delivered to the Recipient's Inbox.
RemainingThe number of email addresses that have not been sent the message yet.
BouncedA "bounce" generally occurs when sending to email addresses that:
- do not exist/spelled incorrectly
- have full inboxes
- are too old and not used anymore
- block domains with poor sender reputation (too many spam complaints)
- have a restrictive DMARC record for your sending domain.

See How to improve email deliverability for more details.
FailedOneSignal could not deliver the email to the Recipient's Inbox and will drop the message. See below FAQ Why are emails marked as failed? for details.
Unique OpensThe number of unique email opens.

Some email inbox privacy settings could affect these numbers.
Total OpensThe total number of times the email was opened.

Includes when a single email was opened multiple times.
Unique ClicksThe number of recipients that have clicked a link in this email.

Click Tracking must be enabled.
Total ClicksThe total number of times a link in the email was clicked. Includes when a single email link was clicked multiple times.
Unique Click to Open Rate(Unique Clicks / Unique Opens) * 100%
UnsubscribesThe number of recipients who opted out of your emails using the unsubscribe link in this email.
Reported as SpamThe number of recipients who clicked the spam button for this email.


API Message Data Retention Limit

Messages sent from the OneSignal API or Automated Messages are only saved for about 30 days.
You can export message data for your records through our API or Dashboard. See Exporting Data for more details.


Why are my emails marked as failed?

The two most common reason for failed emails are:

  1. Sending to non-existant email domains. E.g [email protected]
  2. Sending to emails that are on your ESPs Suppression list.
  • If you are using Custom Unsubscribe Links in your emails, you will need to also unsubscribe the email address within OneSignal.
  • If you are sending to a previously bounced emails, it will be added to your ESPs Suppression list and will be marked as failed for each message going forward.

Failed emails can occur for several reasons but if you are adhering to email best practices, the number of failures should be low. See How to improve email deliverability for more details.

Which Email Service Providers support which statistics?

Not all email service providers provide the full range of possible email statistics.

MailgunYesYesYesYes (bounce)Yes