OOmnistu

Blog / Mobile App Development

Mobile App Development

Universal links on iOS: opening your app from a link, safely

How iOS routes HTTPS URLs into your app, the two-way domain association that makes it trustworthy, and Apple's warning about validating link input.

OOmnistu
Reviewed 2026-11-19 · 3 min read

When someone taps a link to your site on an iPhone, you usually want your app to open that content directly - not Safari, and not a redirect trampoline. That is what universal links do: ordinary HTTPS URLs that iOS routes straight into your app when it is installed. They are also one of the most commonly misconfigured parts of an app launch.

This guide follows Apple's own developer documentation, checked 19 November 2026.

What a universal link is (and is not)

A universal link is a normal HTTPS URL on a domain you own. When a user activates it, iOS checks whether an installed app is associated with that domain and path; if so, the system launches your app and hands it the URL. If not, the same URL opens in the browser - which is why the web page must always work as the fallback. Custom URL schemes (myapp://) by contrast fail hard when the app is missing and can be claimed by any app; universal links are verified against your domain.

The two halves of the setup

Apple's documentation breaks support into two steps:

The security warning teams skip

Apple's own page carries a warning that deserves to be treated as a requirement: universal links are a potential attack vector into your app. Validate all URL parameters and discard malformed URLs; limit link-driven actions to ones that cannot risk user data - a universal link should never directly delete content or expose sensitive information; and include improperly formatted URLs in your test cases. A link is untrusted input, exactly like a form field.

Failure modes to test before launch

Related: allowlist-testing redirect targets covers the same untrusted-URL discipline on the web side, and ASO basics covers how your store listing and site work together.

Sources

Drafted with AI assistance from this source. Entitlement and association-file specifics change between iOS releases; follow Apple's current "Supporting associated domains" documentation for the exact file format and hosting rules.