Skip to main content
Deliverability insights break your email metrics down by inbox provider, so you can see how Gmail, Outlook, Yahoo, Apple, and others handle your mail. A problem that’s invisible in your overall numbers, such as bounces concentrated at one provider or a spam-complaint spike at another, stands out once the stats are split by provider. Use it to find where deliverability is slipping and act before it drags down your whole sender reputation.
Deliverability insights are available for apps sending through OneSignal Mail. If your app sends through a connected third-party provider (for example SendGrid, Mailchimp, or your own Mailgun account), use that provider’s dashboard instead. Your sending domain must also be authenticated.

Where to find it

In the OneSignal dashboard, go to Messages > Email and open the Deliverability insights tab. This is the per-provider companion to the overall Reputation dashboard (Settings > Email > Reputation), which summarizes the same metrics across all providers combined. You can adjust what you’re looking at with the controls at the top:
  • Domain: if your app sends from more than one authenticated domain, pick which one to view.
  • Date range: choose a preset (7, 30, or 90 days) or a custom range. Custom ranges can go back up to 1 year, matching how long this data is retained.
  • Provider filter: narrow the timeseries chart to specific providers.
  • Refresh: pull the latest stats. A “last updated” timestamp shows how fresh the current data is.

What you’ll see

Sender reputation cards

Four cards summarize the selected domain and date range across all providers combined: Each card carries a status badge (Good, Okay, At risk, or Poor) so you can tell at a glance whether a metric needs attention. For what each metric means for your overall reputation and how to respond, see Email deliverability.

Per-provider table

The table breaks the same metrics (sent, delivered, opened, clicked, failed, bounced, and spam complaints) out by inbox provider, largest sender first. For definitions of each metric, see Email message reports and the Metrics glossary.

Timeseries chart

Plot metrics over time for the selected date range. Use the provider filter to compare providers or focus on one. The chart totals the metrics across whichever providers you’ve selected.

Notices

When a provider’s metrics cross a threshold, OneSignal surfaces a notice. Notices come at two levels:
  • At risk (warning): a metric is slipping and worth acting on soon.
  • Poor (risk): a metric is actively hurting your reputation, so address it now.
What a notice points to depends on the metric: For what drives reputation up or down and how to respond, see Email deliverability and Email reputation best practices.

Understanding the inbox providers

Recipients are grouped by the provider that actually runs their mail, not always by the address domain. For example, you@yourcompany.com may appear under Google Workspace if that company uses Gmail. In the provider filter, these are organized into Global, North America only, Europe only, Asia only, and Other groups.

Important caveats

Read these before drawing conclusions from the data.
Low volume means less reliable numbers. Rates calculated from a small number of sends swing wildly, so a handful of bounces can look like a serious problem. Providers below a minimum send volume are flagged with a Limited data badge.

Spam complaints aren’t reported everywhere

Not every provider tells senders when a recipient marks a message as spam:
  • Apple does not report spam complaints at all. Apple’s complaint numbers will read as zero even if recipients are reporting your mail. This is an Apple limitation, not a gap in OneSignal.
  • Gmail complaints require Google Postmaster Tools. Gmail doesn’t share per-recipient complaints either. To see a Gmail spam rate, connect Postmaster Tools by adding mailmonitor@onesignal.com as a managed user for your domain (see the setup steps). Until then, the Gmail spam figure will be unavailable.
  • Yahoo and Outlook do report complaints through feedback loops, so their numbers are populated directly.
For more on why complaint data is uneven across providers, see How spam rate is calculated.

Data is per domain, not per app

These stats are reported at the sending-domain level. If the same domain is used by more than one app, the numbers combine every app that sends from it. They are not split per app. When the selected domain is shared, the page shows a “Used in N apps” indicator so you know the totals are aggregated. For reputation purposes the domain-level view is what matters, since inbox providers judge the domain as a whole.

Data source, freshness, and retention

  • Retention: hourly detail is available for the most recent 24 hours; daily data goes back up to 1 month.
  • Freshness: Postmaster-sourced Gmail data lags by roughly 1–2 days, and Gmail only publishes it once your domain clears its own minimum daily volume.
  • Directional, not exact: these numbers are for spotting trends and problems, not for billing or reconciliation, and may differ slightly from other reports.

Email deliverability

Core concepts: reputation, inbox placement, bounces, and spam complaints.

Google Postmaster Tools

Connect Postmaster to unlock Gmail spam-rate and reputation data.

Email reputation best practices

Actionable steps to protect and improve your sending reputation.

Email message reports

Per-message delivery, open, and click stats with full metric definitions.