---
title: Track push notifications - Flutter
description: Learn how to track mobile notification interactions automatically with CSQ
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-flutter/product-analytics/track-push-notifications/
  md: https://docs.contentsquare.com/en/csq-sdk-flutter/product-analytics/track-push-notifications/index.md
---

> ## Documentation index
> Fetch the complete documentation index at: 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 CSQ

## Initializing Notification Autocapture

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

* Product Analytics

  **main.dart**

  ```dart
  await CSQ().start(
    startConfig: StartConfig.withEnvironmentId(
      id: 'YOUR_ENVIRONMENT_ID',
      options: AnalyticsOptions(
        enablePushNotificationAutocapture: true,
      ),
    ),
  );
  ```

* CSQ Experience Platform (Early Access)

  **main.dart**

  ```dart
  await CSQ().start(
    startConfig: StartConfig.withDatasourceId(
      id: 'YOUR_DATASOURCE_ID',
      options: AnalyticsOptions(
        enablePushNotificationAutocapture: true,
      ),
    ),
  );
  ```

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

* Product Analytics

  **main.dart**

  ```dart
  await CSQ().start(
    startConfig: StartConfig.withEnvironmentId(
      id: 'YOUR_ENVIRONMENT_ID',
      options: AnalyticsOptions(
        enablePushNotificationAutocapture: true,
        enablePushNotificationTitleAutocapture: true,
        enablePushNotificationBodyAutocapture: true,
      ),
    ),
  );
  ```

* CSQ Experience Platform (Early Access)

  **main.dart**

  ```dart
  await CSQ().start(
    startConfig: StartConfig.withDatasourceId(
      id: 'YOUR_DATASOURCE_ID',
      options: AnalyticsOptions(
        enablePushNotificationAutocapture: true,
        enablePushNotificationTitleAutocapture: true,
        enablePushNotificationBodyAutocapture: true,
      ),
    ),
  );
  ```

Once registered, CSQ 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.


```json
{"@context":"https://schema.org","@type":"TechArticle","headline":"Track push notifications","description":"Learn how to track mobile notification interactions automatically with CSQ","url":"https://docs.contentsquare.com/en/csq-sdk-flutter/product-analytics/track-push-notifications/","inLanguage":"en","dateModified":"2026-07-08T20:51:53+02:00","publisher":{"@type":"Organization","name":"Contentsquare","url":"https://www.contentsquare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://docs.contentsquare.com/#website","name":"Contentsquare Technical Documentation","url":"https://docs.contentsquare.com/"}}
```