> ## 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.

# Template analytics

> Review delivery statistics, engagement metrics, and audience activity for push, email, and SMS templates in OneSignal.

Template analytics show how your push, email, and SMS templates perform — delivery outcomes, engagement metrics, and per-recipient activity. Open a template report by clicking any template in the dashboard. To modify the template, click **Edit**.

<Note>
  Template analytics are retained for up to 2 years depending on your [pricing plan](https://onesignal.com/pricing). Per-recipient audience activity data is retained for 30 days from the time the message is sent.
</Note>

## How to access and use template analytics

<Steps>
  <Step title="Go to Templates">
    In your OneSignal dashboard, navigate to **Messages > Templates**.

    Select a template that has been used for at least one send, or create a new template and send a test message.
  </Step>

  <Step title="Review analytics and statistics">
    The template report displays performance metrics and delivery statistics, organized by channel (push, email, or SMS).

    Use these metrics to monitor engagement, troubleshoot delivery issues, and evaluate template effectiveness.
  </Step>

  <Step title="Edit or export data">
    Click **Edit** at the top of the report to modify the template.

    Click **Export** to download per-recipient activity as a CSV.
  </Step>
</Steps>

## Template statistics by channel

Each channel reports its own delivery and engagement metrics. For canonical metric definitions across all channels, see the [Metrics glossary](./analytics-metrics-glossary).

<Tabs>
  <Tab title="Push">
    ### Summary

    | Name                                | Description                                                                                                                                                               |
    | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Delivered                           | The number of push notifications successfully sent to and accepted by the push provider (FCM, APNs, HMS).                                                                 |
    | Click-Through Rate (CTR)            | `(Clicked / Delivered) × 100`.                                                                                                                                            |
    | Confirmed Click-Through Rate (CCTR) | `(Clicked / Confirmed Receipt) × 100`.                                                                                                                                    |
    | Influenced Opens                    | Users who opened the app within the influenced time window without directly clicking the notification. Configure this in **Settings > Push & In-app > Influenced Opens**. |

    ### Delivery statistics

    | Name              | Description                                                                                                                                                                                                                                                                                                                                                                                          |
    | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Sent              | The number of push notifications sent from OneSignal, including both those successfully sent to the push provider and failures. Composite metric.                                                                                                                                                                                                                                                    |
    | Delivered         | The number of push notifications successfully sent to and accepted by the push provider (FCM, APNs, HMS).                                                                                                                                                                                                                                                                                            |
    | Confirmed Receipt | The number of push notifications confirmed as received by the device, verified by the OneSignal SDK. Several factors can affect this count — see [Confirmed receipt](./confirmed-delivery).                                                                                                                                                                                                          |
    | Unsubscribed      | The number of push Subscriptions that did not receive the push notification because they uninstalled the app, cleared browser data, or opted out of push. OneSignal does not attempt to send to these Subscriptions in future messages. Older tokens may also expire — see [FCM expired tokens](./fcm-expired-token-faq) and [unsubscribe causes](./push-notification-message-reports#unsubscribed). |
    | Failed            | The number of push Subscriptions that did not receive the push notification because of an error. See [push error reference](./push-notification-message-reports#failed) for common causes.                                                                                                                                                                                                           |
    | Remaining         | The number of Subscriptions in the target audience that haven't yet received the push notification (queued or in flight).                                                                                                                                                                                                                                                                            |
    | Frequency Capped  | The number of push Subscriptions that did not receive the push notification due to [frequency cap](./frequency-capping) settings.                                                                                                                                                                                                                                                                    |

    ### Conversion statistics

    <Info>
      **Coming soon** — [Conversion metrics](./conversion-metrics) will be available on template reports. Once available, you will see attributed and influenced conversions aggregated across all messages sent from this template.
    </Info>

    ### Outcome statistics (legacy)

    <Warning>
      Custom Outcomes is being deprecated and replaced by [Conversion metrics](./conversion-metrics).
    </Warning>

    | Name              | Description                                                                                                                                                                                                                    |
    | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | Clicks            | Direct clicks or opens on the push message. Always measured with direct attribution.                                                                                                                                           |
    | Confirmed Receipt | The number of push notifications confirmed as received by the device. See [Confirmed receipt](./confirmed-delivery). [Paid plan required](https://onesignal.com/pricing).                                                      |
    | Sessions          | Count or cumulative duration (in seconds) of app sessions attributed to this push. A new session starts only after the app has been out of focus for 30+ seconds. [Professional plan required](https://onesignal.com/pricing). |
    | Custom Outcomes   | Custom metrics like purchase amount or user actions, configured in your app code. See [Custom Outcomes](./custom-outcomes).                                                                                                    |
  </Tab>

  <Tab title="Email">
    ### Summary

    | Name                     | Description                                                                                                                                   |
    | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
    | Open Rate                | `(Unique Opens / Delivered) × 100`. User privacy settings may affect open tracking — see [Why are open events low?](#why-are-open-events-low) |
    | Click-Through Rate (CTR) | `(Unique Clicks / Delivered) × 100`. Requires [click tracking enabled](./unsubscribe-links-email-subscriptions).                              |
    | Unsubscribed             | The number of recipients who opted out via the unsubscribe link in this email.                                                                |

    ### Delivery statistics

    | Name         | Description                                                                                                                                                                              |
    | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Audience     | The number of Subscriptions in the targeted Segment(s).                                                                                                                                  |
    | Sent         | The number of emails sent from OneSignal, including both those successfully sent to the email service provider and failures. Composite metric.                                           |
    | Delivered    | The number of emails successfully delivered to the recipient's inbox server.                                                                                                             |
    | Remaining    | The number of Subscriptions in the target audience that haven't yet received the email (queued or in flight).                                                                            |
    | Total Clicks | The total number of times a link in the email was clicked, including repeats. See [URLs, links and deep links](./links).                                                                 |
    | Total Opens  | The total number of times the email was opened, including repeats. Privacy settings may affect this — see [Why are open events low?](#why-are-open-events-low)                           |
    | Unsubscribed | The number of recipients who opted out via the unsubscribe link.                                                                                                                         |
    | Bounced      | The number of emails rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. Bounced addresses are added to the [suppression list](./email-deliverability). |
    | Failed       | The number of emails unable to be delivered to the inbox, excluding bounces. See [Why are emails marked as failed?](#why-are-my-emails-marked-as-failed)                                 |
    | Suppressed   | The number of emails blocked due to prior bounces or spam reports to protect sender reputation. Only recorded for apps configured to use [OneSignal Email](./email-setup).               |

    <Note>
      Email templates do not currently support Conversion metrics or Custom Outcomes.
    </Note>
  </Tab>

  <Tab title="SMS">
    ### Summary

    | Name          | Description                                                                                         |
    | ------------- | --------------------------------------------------------------------------------------------------- |
    | Delivery Rate | `(Delivered / Sent) × 100`.                                                                         |
    | Failure Rate  | `(Failed / Sent) × 100`. For a combined view of carrier rejections, also review **Rejected** below. |

    ### Delivery statistics

    | Name       | Description                                                                                                                            |
    | ---------- | -------------------------------------------------------------------------------------------------------------------------------------- |
    | Audience   | The number of Subscriptions in the targeted Segment(s).                                                                                |
    | Sent       | The number of messages sent from OneSignal, including both those successfully sent to Twilio and failures. Composite metric.           |
    | Delivered  | The number of messages successfully delivered to the carrier as reported by Twilio.                                                    |
    | Failed     | The number of messages that failed to be sent to Twilio.                                                                               |
    | Suppressed | The number of messages not sent to the Subscriptions because they opted out of receiving messages from the sender.                     |
    | Rejected   | The number of messages not delivered by the carrier due to number blockage, velocity blockage, or the recipient being on a block list. |

    <Note>
      **Sent** and **Delivered** on SMS both represent upstream confirmations (OneSignal → Twilio, Twilio → carrier). Neither guarantees the recipient's device has received the message.
    </Note>

    <Note>
      SMS templates do not currently support Conversion metrics or Custom Outcomes.
    </Note>
  </Tab>
</Tabs>

## Audience activity

Audience activity reports break down each recipient's delivery result so you can segment for retargeting and monitor Subscription health.

<Tabs>
  <Tab title="Push">
    * Lists each Subscription and its delivery result (sent, confirmed, clicked, failed, unsubscribed).
    * Click **Export** to download the full Subscription list.
    * A dash or blank entry in the **Device** column means the Subscription has since been deleted.
  </Tab>

  <Tab title="Email">
    Lists each email Subscription and its status: delivered, opened, clicked, unsubscribed, bounced, failed, or complained. Timestamps reflect the most recent event.

    * **Export** activity data, including failure reasons.
    * **Retarget** users based on activity data to follow up. See [Retargeting messages](./retargeting).
  </Tab>

  <Tab title="SMS">
    Lists each SMS Subscription as sent, delivered, or failed. See [Retargeting messages](./retargeting).
  </Tab>
</Tabs>

<Note>
  Audience activity is retained for 30 days from the time the message is sent.
</Note>

## FAQ

### How long is template data stored?

Template analytics are retained for up to 2 years depending on your plan. Per-recipient audience activity is retained for 30 days. See [Analytics data retention](./billing-faq#analytics-data-retention) for details.

### Why are open events low?

Email open tracking relies on a tracking pixel that loads when the recipient opens the email. Many email clients and privacy features (Apple Mail Privacy Protection, Gmail image proxying) block or pre-fetch this pixel, which under-reports opens. Click tracking is generally a more reliable engagement signal.

### Why are my emails marked as failed?

A "failed" email means OneSignal could not deliver the message and dropped it. Common causes:

* The recipient's email address is invalid or misspelled.
* The recipient's mailbox is full.
* The receiving server rejected the message (for example, content filtering or sender reputation).
* A DNS or authentication issue with your sending domain (SPF, DKIM, DMARC).

Check your [email deliverability settings](./email-deliverability) and sending domain configuration if you see a high failure rate.

### What does "Suppressed" mean?

A suppressed message was intentionally withheld by OneSignal. For email, this happens when the recipient previously reported your email as spam or their address hard-bounced, which protects your sender reputation. For SMS, this happens when the Subscription opted out of receiving messages from the sender. See [Suppressions](./suppressions).

### Can I export audience activity data?

Yes. Click the **Export** button in the Audience Activity section to download a CSV with per-recipient delivery results, including failure reasons and timestamps.

## Related

<Columns cols={2}>
  <Card title="Metrics glossary" icon="book" href="./analytics-metrics-glossary">
    Full definitions for all analytics metrics across channels.
  </Card>

  <Card title="Push message reports" icon="file-chart-column" href="./push-notification-message-reports">
    Delivery and engagement reports for individual push messages.
  </Card>

  <Card title="Email deliverability" icon="envelope-circle-check" href="./email-deliverability">
    Improve delivery rates and manage bounces, spam reports, and sender reputation.
  </Card>

  <Card title="Templates" icon="copy" href="./templates">
    Create and manage reusable message templates across channels.
  </Card>

  <Card title="Confirmed receipt" icon="circle-check" href="./confirmed-delivery">
    How confirmed receipt tracking works and what affects the count.
  </Card>

  <Card title="Frequency capping" icon="gauge-high" href="./frequency-capping">
    Limit how often users receive messages to reduce fatigue.
  </Card>
</Columns>