Skip to Content
Platform.Ontology

Linking an app to a website

Proves the app and website are owned together, enabling app links and shared passwords.

Works without askingOther apps on the phoneLinksAndroid and iPhoneWhen the app opens

In one line

Can open web links in the app and offer saved passwords once linked

Proves the app and website are owned together, enabling app links and shared passwords.

Domain verification file on the website, not a user prompt. Also feeds password autofill.

What it can and can't do

What the user does: Nothing at install. You later tap a web link or a password field

It can

  • Open web links from that company directly in its app
  • Offer your saved website passwords inside the app
  • Hand off what you were doing between your devices (iPhone)

It cannot

  • Link to a site that has not published a matching proof file
  • Show a prompt; you can only turn link opening off in Settings
  • See your saved passwords without you picking one

How it differs between platforms: iPhone has a per link switch in Settings. Android 12 and later lets you change link handling per app.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 6.0 (API 23)iOS 9
Permission or entitlementNone; autoVerify intent filter plus assetlinks.jsoncom.apple.developer.associated-domains (applinks, webcredentials, activitycontinuation)
Protection levelnoneentitlement
How access is grantedinstallinstall
What the user seesNone; user can change in SettingsNone; Settings per app link toggle
How long it lastsUntil app updateUntil app update
How to take it backSettings > Apps > Open by defaultSettings > Apps > Open links
Store policyNone listedNone listed
APIDigital Asset Links, intent filtersapple-app-site-association file
NotesVerified at install; Android 12 tightens link handlingApple CDN caches the file; iOS 14 added swcd checks

Data you get

What comes back: Verified domain list
Shape: none
How often: static

FieldTypeUnitRangePrecision
domainslisthostsup to about 20Not listed

Technical limits

  • Verification file hosted by developer

The story

What it is

A secret handshake that proves an app and a website belong to the same company.

For you

You never see a prompt. You just notice that tapping a link opens the right app, and that your saved password pops up for both the app and the website.

For makers

Makers publish a small file on their website that says 'this app is ours'. That unlocks links that open in the app, shared password autofill and sign in handoff, and it keeps look-alike apps from hijacking links.

Where you see it

TypeExampleApps
shoppingYou tap an Amazon link in a text message and the Amazon app opens on that exact product instead of a web page.Amazon
socialA friend sends an Instagram post link and it opens in the Instagram app, already logged in.Instagram
bankingYour bank's app shows your saved login suggestion because the phone knows the app and bank.com are the same company.Chase, Bank of America
gamesA friend's invite link for a mobile match opens the game lobby directly, so you join the party in one tap.Roblox, Fortnite
rideshareA shared trip link opens Uber on the live map so a friend can follow your ride.Uber, Lyft
securityThe phone refuses to open a fake app that tries to catch links meant for a real bank, because it cannot show the handshake file.None named

Risks

  • Link hijacking if misconfigured
  • Hidden link between app and site

Android and iPhone in short

  • Android: Android checks the file when the app installs and can open verified links without asking.
  • iPhone: iOS caches the file through Apple's servers and also uses it for shared password autofill.

What the platform says

Good uses and abuse

Legitimate uses

  • Deep links
  • Autofill

Known abuse

  • Link hijacking

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2015-09, iPhone iOS 9: Universal Links
  • 2015-10, Android 6.0 (API 23): App Links verification

Sources

How well checked: Based on official documentation.

On this page