Skip to Content
Platform.Ontology

Protocol Handlers

Lets a site or installed app handle links like mailto: or web+music:.

Works without askingHome screen and system linksLinksWeb browsersWhile you use it

In one line

Can open links like mailto: in the site after you approve it

Lets a site or installed app handle links like mailto: or web+music:.

Opens links with that scheme in the site after the person approves.

What it can and can't do

What the user does: You tap a mailto: or similar link and approve the site as its handler

It can

  • Open that kind of link in the site after you approve
  • Handle custom link types like web+music:
  • Ask again if you change your mind in settings

It cannot

  • Take over links without your approval
  • Work in Firefox for most link types, Safari or on phones
  • Open links in other apps
  • Hijack links from sites you never approved

How it differs between platforms: Chrome and Edge on computers ask first. Firefox, Safari and phones do not support it.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported962021-11-15None
EdgeSupported962021-11-19None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APInavigator.registerProtocolHandler(scheme,url); manifest protocol_handlers
Browser compat keysmanifests.webapp.protocol_handlers
How access is grantedprompt
What the user seesHandler registration prompt
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets a site or installed app handle links like mailto: or web+music:.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
schemestringNonemailto, web+*, ...Not listed

Technical limits

  • Safari ignores it
  • Custom schemes must start with web+
  • Manifest handlers desktop only

The story

What it is

A site can ask to open links like mailto: or custom web+ links, so clicking them opens that site.

For you

You may see a small prompt asking to let a site open links of one type, such as mail links. If you allow, clicking such a link opens that site. You can change it in browser settings.

For makers

Makers of web mail, chat and calendar apps want to be the default for those links. It makes their web app part of daily flow. It needs an allow, to stop sites from hijacking links.

Where you see it

TypeExampleApps
messagingGmail asks to handle mailto links, so clicking an email address anywhere opens a new Gmail draft.Gmail
videoA meeting site registers to open meeting links, so clicking one opens its web app.Zoom, Microsoft Teams
musicA web music player handles a custom music link type, so a shared link starts the song.None named
gamesA web game launcher handles invite links so a click opens the right game room.None named
productivityA web calendar app handles calendar links to add events.Google Calendar
socialA chat web app handles chat invites from messages and web pages.Discord, Telegram Web
securityA malicious site tries to take over mail links to capture drafts. The prompt gives you a chance to refuse.None named

Risks

  • Link hijack risk
  • Easy to click allow

What the platform says

Good uses and abuse

Legitimate uses

  • Mailto handlers

Known abuse

  • Link hijacking

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility2 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

  • 2010, Chrome 13: registerProtocolHandler
  • 2021, Chrome 96: Manifest protocol_handlers on desktop

Sources

How well checked: Checked against real behavior.

On this page