Configuring the 'Mailto' Protocol for Gmail in Chrome

These instructions have been tested with the Chrome browser version below.
07-19-2023 Chrome Version 115.0.5790.99 (Official Build) (64-bit)
"Mailto" is a Uniform Resource Identifier (URI) scheme for email addresses, which is used to produce hyperlinks on websites that allow users to send an email to a specific address directly from an HTML document. If you are using Gmail, mailto commands will not work by default and you must configure "mailto" for use with Gmail. OA Mobile, like any other application or webpage, uses the "mailto" URI to send email to your preferred email client. If you do not have the "mailto" command configured to use your preferred email client, OA Mobile (nor any other application or webpage) will be able to send email to your preferred email client. Please follow steps A - D below to complete the configuration.

When you configure Google Gmail to use the "Mailto" URI, you are telling applications to send URI links to your Google Gmail account. Before Proceeding, log out of any open gmail accounts you are currently in, and close the Google Chrome browser (this means shut it down, not just minimize it). You can only send email to one active gmail account at a time via the "Mailto" URI. This means that if you are logged into multiple google and/or gmail accounts, the "mailto" URI will not work and/or will be unpredictable.
  1. Open Chrome and locate the three vertical dots on the top right side of the browser, click on these vertical dots.
  2. Within the drop down list, select |Settings|.
  3. Select the three horizontal line icon to open the Google Chrome settings subsections (you can skip this step if your screen is maximized).
  4. From the menu on the left, select |Privacy and Security|.
  5. From the |Privacy and Security| section, select |Site Settings|.
  6. From the |Permissions| section, select |Additional Permissions|.
  7. From the |Additional Permissions| section, select |Protocol Handlers|.
  8. From the |Protocol Handlers| section, make sure 'Sites can ask to handle protocols' is selected. If there are any sites already listed below the default behavior section, remove them. Close the Chrome browser.

  9. Configure Gmail Mailto

Windows 11

  1. From Windows 11, select the |Start| menu.
  2. Search for 'Default apps'.
  3. Select |Default apps|.
  4. From the 'Default apps' section, select |Google Chrome|.
  5. From the 'Google Chrome' section, select the |MAILTO| section to open the list of applications.
  6. From the 'Select a default app for MAILTO links' section, select |Google Chrome|.
  7. Select the |Set Default| button.
  8. Configure Windows 11 Global


  1. Open your gmail account and select the "Double Black Diamond Icon" to the right of the address bar.
  2. Select |Allow|.
  3. Select |Done|.


  4. Setting Permissions in Gmail

Click the Test Mailto Settings link. If you have configured your 'Mailto' settings correctly, the link should open an email within your gmail account.


© 1991-2024 - Baseline Data Systems, Inc.