App Tracking Transparency

Last updated: May 22, 2026

App Tracking Transparency (ATT) is an iOS requirement. Before your app can track user activity across other apps and websites — for advertising, analytics, or attribution — iOS shows a system permission dialog asking the user for consent. This module lets you configure the message in that dialog and control when it appears.

What the Dialog Looks Like

When ATT is triggered, iOS shows a native prompt with your app name and a message similar to:

"[Your App] Would Like Permission to Track You"
"Your data will be used to deliver personalised content and ads."

The second line is your custom message. You control its content.

Pop-up Description Message

The text shown inside the ATT permission dialog, below Apple's standard heading.

  • Default: Your data will be used to deliver personalised content and ads.
  • Maximum length: 500 characters

This text is stored in your app's Info.plist as NSUserTrackingUsageDescription. Apple reviews it during app review, so it must accurately describe why tracking is needed.

Write a message that:

  • Clearly explains what data is used
  • Mentions the benefit to the user (personalized content, relevant ads, better experience)
  • Is honest and specific

Example: We use your data to measure ad performance and show you content and offers relevant to your interests.

Show Consent Pop-up Only on These URLs

By default, the ATT prompt appears when the app launches for the first time. You can instead delay it until the user reaches a specific page — for example, a page where ads are shown or analytics tracking begins.

Enter one domain, full URL, or URL fragment per line. Supports wildcard patterns (*) and exact match brackets [ ].

ExampleMatches
example.com/homeAny URL containing /home
[example.com/dashboard]Only the exact URL example.com/dashboard

If left empty, the prompt appears at app startup. If URLs are listed, the prompt appears the first time the user visits one of those pages.

Note: ATT is iOS-only. This setting has no effect on Android apps.