Getting Gmail to handle all mailto: links with registerProtocolHandler
Google Developers Logo

Missed the Chrome Developer Summit?

All sessions available on demand - Watch Now

If you use Gmail you may become frustrated when you click a mailto: link by accident and now your desktop client of Outlook or Mail starts up. Thanks to navigator.registerProtocolHandler() (which we've covered here before) you can wire up Gmail as your default mail client for all mailto: links in Chrome and Firefox.

Screenshot of registerProtocolHandler prompt

Here’s how:

  1. First, open up a Gmail tab. You must do this from the Gmail tab, not your html5rocks one. :)
  2. Open your javascript console (cmd-opt-j on Mac, ctrl-shift-j on Windows) and enter:
  3. navigator.registerProtocolHandler("mailto",
  4. Accept the confirmation from the browser.
  5. Click this mailto: link to test out your new Gmail mailto hookup!

    Boom. Enjoy.

    If you ever need to removing this setting, you can do that at chrome://settings/handlers in Chrome and Preferences->Applications->mailto in Firefox.


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.