---
title: Track push notifications - iOS
description: Learn how to track mobile notification interactions automatically with Contentsquare
lastUpdated: 08 July 2026
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-ios/product-analytics/track-push-notifications/
  md: https://docs.contentsquare.com/en/csq-sdk-ios/product-analytics/track-push-notifications/index.md
---

> Documentation index: https://docs.contentsquare.com/llms.txt
> Use this file to discover all available pages before exploring further.

After completing the setup process you will be able to:

* Automatically track interactions on your mobile notifications
* Define and analyze notification interaction events in Contentsquare

## Initializing Notification Autocapture

Notification autocapture can be initialized with `enablePushNotificationAutocapture: true` in `CSQ.start()`.

* Product Analytics

  ```swift
  CSQ.start(
    environmentID: "YOUR_ENVIRONMENT_ID",
    options: [
      .enablePushNotificationAutocapture: true
    ]
  )
  ```

* CSQ Experience Platform (Early Access)

  ```swift
  CSQ.start(
    dataSourceID: "YOUR_DATASOURCE_ID",
    options: [
      .enablePushNotificationAutocapture: true
    ]
  )
  ```

Capture the title or body text of the notification where an interaction was performed using `enablePushNotificationTitleAutocapture` and `enablePushNotificationBodyAutocapture`.

* Product Analytics

  ```swift
  CSQ.start(
    environmentID: "YOUR_ENVIRONMENT_ID",
    options: [
      .enablePushNotificationAutocapture: true,
      .enablePushNotificationTitleAutocapture: true,
      .enablePushNotificationBodyAutocapture: true
    ]
  )
  ```

* CSQ Experience Platform (Early Access)

  ```swift
  CSQ.start(
    dataSourceID: "YOUR_DATASOURCE_ID",
    options: [
      .enablePushNotificationAutocapture: true,
      .enablePushNotificationTitleAutocapture: true,
      .enablePushNotificationBodyAutocapture: true
    ]
  )
  ```

Once registered, Contentsquare will begin collecting interaction events on notifications.

## What's Next?

With notification data flowing, you'll want to jump into the Product Analytics app and start defining notification interaction events. These events will show up as a special "Notification Interaction" event type in Product Analytics and have several properties available to create definitions:

* **Notification Title**: The title text of the notification. Capture can be enabled/disabled via a config option as described above.
* **Notification Body**: The body text of the notification. Capture can be enabled/disabled via a config option as described above.
* **Notification Action**: The text of the notification action that was interacted with, if any.
* **Notification Source**: What caused the notification to fire. This could be a push service, a geofence, or unknown.
* **Notification Handling Component**: The name of the component in code that handled the notification interaction.
* **Notification Category**: This is the notification channel that the notification was delivered to. This typically denotes the type of notification that with which the interaction occurred.