iOS universal links referrer
On iOS, a universal link lets a tapped https URL open directly in an installed app instead of the browser. Because the transition skips a normal web navigation, there is usually no HTTP Referer header for the destination, so universal-link visits often arrive as direct and UTM parameters are the reliable way to attribute them.
What universal links do
On iOS, universal links associate specific https URLs with an installed app so that tapping such a link opens the app directly rather than loading the page in Safari. The system decides at tap time whether to route to the app or the web based on the app's association configuration.
This is great for user experience but disrupts referrer-based attribution: the click does not necessarily produce a standard browser navigation to your web page, so the chain that normally sets a Referer header is broken.
- An https tap can open an app instead of the browser
- No standard web navigation means no HTTP Referer is set
- Routing is decided by the app's universal-link association
Why the referrer is usually absent and what to do
Because the transition can bypass the browser entirely, the destination often receives no Referer header, and when the user is later returned to the web, the visit commonly appears as direct or unknown. This is expected platform behaviour, not a tracking bug.
The query string, however, travels with the URL into the app and back out, so UTM parameters are the dependable attribution signal. Tag the links you distribute that may resolve as universal links with utm_source and utm_medium, and capture those parameters at first load so the original source is preserved even though no referrer was sent.
How it appears in analytics and logs
A universal link routes an https URL into an app rather than the browser, so the web navigation that would set a Referer header may not happen. When the journey returns to the web, the visit commonly appears as direct with no referrer.
Diagnostic use case
Understand why iOS app openings and app-to-web transitions frequently lack a referrer, and rely on UTM parameters rather than the Referer header for attribution.
What WebmasterID can help detect
WebmasterID reads UTM parameters that survive the universal-link handoff and treats referrer-less app transitions as direct/unknown, so iOS app-linked visits are classified honestly without invented sources.
Common mistakes
- Expecting an HTTP referrer from a universal-link app handoff.
- Treating universal-link direct traffic as a measurement bug rather than platform behaviour.
- Not tagging links that may resolve as universal links, losing them to direct.
Privacy and accuracy notes
Universal-link attribution should use only UTM parameters on the URL — no device or user fingerprint. WebmasterID treats the missing referrer as direct/unknown and never infers identity.
Related pages
- Android intent referrer
When an Android app opens a web URL, it can attach an Intent referrer (EXTRA_REFERRER) indicating which app launched the browser. This is an Android platform mechanism distinct from the HTTP Referer header — some browsers expose it and some do not — so app-originated visits may or may not reveal the launching app, and UTM tags remain the reliable cross-platform signal.
- Referrers in single-page apps
In a single-page app, the History API changes the URL and view without a full page load, so the browser does not send a new Referer header for each route. The header reflects the original entry point, not the internal navigation, which means SPA analytics must capture referrer and entry data at first load and track route changes separately.
- Referrer-Policy and missing referrers
Referrer-Policy is the web standard that controls how much of the referrer a browser sends with a request. Site owners set it via an HTTP header or a meta tag, and modern browsers default to a privacy-leaning value. Understanding the policy values explains why so many referrers arrive trimmed to the origin or missing entirely.
- Campaign links
Tag links so iOS universal-link app transitions stay attributable without a referrer.
Sources and verification notes
- Apple Developer — Supporting universal linksUniversal links open https URLs in an app, bypassing a normal browser navigation.
- MDN — Document.referrer
Last reviewed 2026-06-24. Facts are checked against primary/official sources where available; uncertain specifics are marked “Data not yet verified” rather than guessed.