Deep Link Doctor
Home / Developer notes

Universal link opens Safari when typed or pasted

A universal link typed or pasted into Safari always loads the website. This is expected iOS behaviour, not a broken file. How to test universal links properly.

SymptomTyping or pasting a universal link into the Safari address bar loads the website instead of the app.
Likely causeiOS never treats direct navigation in the address bar as a universal link, by design.
FixNothing to fix on the server; test by tapping the link from Notes or Messages instead.

Short answer: This is expected. Apple's debugging technote says direct navigation in the Safari address bar is never treated as a universal link. Your file may be fine. Test by tapping the link in Notes or Messages, where it should open the app.

What is happening

Direct navigation: a URL the user types or pastes into the browser address bar, which iOS always opens in the browser even when a universal link rule matches it.

Universal links respond to a tap on a link. When the user enters a URL themselves, iOS assumes they want the web page. This is the most common false alarm in universal link testing, because pasting a link into Safari is the first thing many people try.

  • The same URL tapped from Notes, Messages or Mail opens the app.
  • sudo swcutil verify on a Mac prints Pattern "..." matched., because nothing is wrong with the file.

Why does this happen?

Apple treats typing a URL as a clear choice to visit the website, so it does not hand that navigation to an app. It is a design decision, documented in Apple's TN3155 technote, not a configuration error.

A related behaviour catches people out: a user can also choose to open a domain in the browser from the long-press menu. Apple says that choice "will set the default behavior for your device", so later taps on that device open Safari too. If one device always opens the website, long-press the link in Notes and choose the app option to reset it.

How to confirm it

  1. Paste the URL into the Notes app and tap it. If the app opens, universal links work.
  2. Long-press the link in Notes. Both an app option and a browser option should appear.
  3. On a device with Developer Mode on, go to Settings > Developer > Universal Links > Diagnostics and enter the URL to see whether it matches.
  4. On a Mac, run sudo swcutil verify -d example.com -j apple-app-site-association -u https://example.com/your/path.

How to fix it

  1. No server change is needed for typed links. Stop testing by pasting into Safari.
  2. Build your test list around taps: Notes, Messages, Mail and a web page on a different domain.
  3. If one device opens Safari on every tap, reset the choice: long-press the link in Notes and choose the app option.
  4. If taps also fail, check the file with curl -I https://example.com/.well-known/apple-app-site-association and sudo swcutil verify, then work through the universal links setup guide.
Quick tap test (iOS)
1. Open Notes, paste https://example.com/product/1
2. Tap the link: the app should open
3. Long-press the link: "Open in <App>" should be listed

If taps from your own website fail as well, see same-domain navigation. Links tapped inside social apps are covered in in-app browsers.

FAQ

Common questions

Is a universal link that opens Safari when typed broken?

No. Apple documents that direct navigation in the address bar is never treated as a universal link. Only taps on links can open the app.

What is the best place to test a universal link?

The Notes app is a reliable test surface. Tap the link to check it opens the app, then long-press it to confirm both the app and browser options appear.

Why does one phone always open the website?

The user may have chosen to open the domain in the browser earlier, and Apple says that choice sets the device's default. Long-press the link in Notes and choose the app option to switch back.

What should the long-press menu show?

When you long-press a working universal link in Notes, Apple's technote says both an option to open the app and an option to open the browser should appear. If only the browser option shows, the link does not match a rule for your app.

What are UTM parameters?

UTM parameters are tags added to the end of a link, such as utm_source and utm_campaign, that tell analytics tools where a visit came from. They let you see which campaign, channel and ad brought each visitor.

Which UTM parameters are required?

Use utm_source, utm_medium and utm_campaign on every campaign link. utm_term and utm_content are optional and help you compare keywords or ad variants.