URL Structure & Documentation

// Understand the mailto.to URL structure

Mail draft links that work for every user, on every device

Link Structure

https://mailto.to/#[to]?[other parameters]
to
Recipient's email address (placed immediately after the # symbol)
cc
Carbon copy recipients (comma-separated for multiple)
bcc
Blind carbon copy recipients (comma-separated for multiple)
subject
Email subject line
body
Main content of the email
from
Sender's email address (Gmail-specific). Sets the '/u/email' parameter in the Gmail URL. Note: This parameter only affects Gmail (desktop/browser) links and allows you to specify which account to send from in multi-account setups.

Example Usage

https://mailto.to/#recipient@example.com?subject=Hello&body=This%20is%20a%20test%20email&cc=cc@example.com&bcc=bcc@example.com&from=sender@gmail.com

Note: Make sure to URL-encode parameter values, especially for the 'body' parameter which may contain spaces and special characters.

Pro Tip

This syntax mirrors the standard mailto: format, allowing easy conversion between mailto: and mailto.to mail draft links. Simply change the protocol and add/remove the hash symbol.

Adding a few characters to your mailto: link, transforms it into a mailto.to mail draft link.

Live Example

mailto.test@example.com?subject=Hello&body=Message

Transformation Process:

  • • Add "https://" at the beginning
  • • Replace "mailto:" with "mailto.to"
  • • Add "/" after the domain
  • • Add "#" before the email address

Why mailto.to mail draft links are better than mailto:

No Email Client Required

mailto: links assume users have an email client configured in their browser. If not, the link fails completely.

mailto.to mail draft links work regardless of email client setup, providing a web-based interface that anyone can use.

Always Accessible Content

mailto: links hide the email content when they fail. Users can't see the subject or body to manually send the email.

mailto.to mail draft links always display the email content, allowing users to copy the information and use it as a fallback.

Shareable Anywhere

mailto: links cannot be shared on social media platforms or messaging apps that don't support email protocols.

mailto.to mail draft links are regular HTTPS URLs that can be shared anywhere - Twitter, Facebook, Slack, or any platform that supports links.

Understanding the 'From' Field

Gmail-Specific Feature
+1

Gmail-Specific Feature

The 'From' field is a special feature that only works with Gmail on desktop browsers. Here's what you need to know:

  • It allows you to specify which Gmail account to use when composing the email.
  • This is particularly useful if you have multiple Gmail accounts logged in simultaneously.
  • The email address you enter here will be used to set the '/u/email' parameter in the Gmail URL.
  • This feature does not work with mobile Gmail apps or other email clients.
Example: If you enter 'work@gmail.com' in the 'From' field, the generated Gmail link will use that account to compose the email. (as long as you've logged into that account in the same browser)