Registering a custom protocol handler
Google Developers Logo

Missed the Chrome Developer Summit?

All sessions available on demand - Watch Now

Chrome 13 finally includes navigator.registerProtocolHandler. This API allows web apps to register themselves as possible handlers for particular protocols. For example, users could select your application to handle “mailto” links.

Register a protocol scheme like:

    'web+mystuff', '', 'My App');

The first parameter is the protocol. The second is the URL pattern of the application that should handle this scheme. The pattern should include a ‘%s’ as a placeholder for data and it must must be on the same origin as the app attempting to register the protocol. Once the user approves access, you can use this link through your app, other sites, etc.:

<a href="web+mystuff:some+data">Open in "My App"</a>

Clicking that link makes a GET request to Thus, you have to parse q parameter and manually strip out data from the protocol.

It’s worth noting that Firefox has had navigator.registerProtocolHandler implemented since FF3. One difference in Chrome’s implementation is around custom protocols. Those need to be prefixed with “web+”, as seen in the example above. The following protocols do not need a “web+” prefix: “mailto”, “mms”, “nntp”, “rtsp”, “webcal”.

More information on this API can be found on the MDN article.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Terms of Service.