mailto link with HTML body
Asked Answered
M

9

407

I have a couple of mailto links in a HTML document.

<a href="mailto:etc...">

Can I insert HTML formatted body in the mailto: part of the href?

<a href="mailto:[email protected]?subject=Me&body=<b>ME</b>">Mail me</a>

Note that (2016) in iOS, it is perfectly fine to add <i> and <b> tags for simple italic, bold formatting.

Microsome answered 11/4, 2011 at 10:58 Comment(3)
Had exactly the same thing in mind and studied it for a while. I was trying to have an embedded remote <img> into the message body. The mailto instruction needs to be URL-encoded in order for it to work. Result with thunderbird was that the HTML body appeared literally, with all its <img> instructions and all. I guess this is a safety issue in thunderbird and most mail clients - they parse incoming mailto-content so that it does not do anything suspicious.Material
The best I could find came from this page, zaposphere.com/html-email-links-code .. Down the bottom gives a list: "Other cool customisations that most other websites don’t mention!!" Helped me out a lot.Downstage
You can set each and every part of an email with basic text. With regards to the limitations that html formatting is not possible, here's a tool I built to make customizing the various fields in a mailto dead simple: mailto.now.shFelicidadfelicie
K
479

As you can see in RFC 6068, this is not possible at all:

The special <hfname> "body" indicates that the associated <hfvalue> is the body of the message. The "body" field value is intended to contain the content for the first text/plain body part of the message. The "body" pseudo header field is primarily intended for the generation of short text messages for automatic processing (such as "subscribe" messages for mailing lists), not for general MIME bodies.

Kistner answered 16/11, 2012 at 11:47 Comment(1)
If you're disappointed by this answer, please keep reading: https://mcmap.net/q/54185/-mailto-link-with-html-body (tl;dr .eml files)Sidelong
E
120

Whilst it is NOT possible to use HTML to format your email body you can add line breaks as has been previously suggested.

If you are able to use javascript then "encodeURIComponent()" might be of use like below...

var formattedBody = "FirstLine \n Second Line \n Third Line";
var mailToLink = "mailto:[email protected]?body=" + encodeURIComponent(formattedBody);
window.location.href = mailToLink;
Estaminet answered 9/5, 2012 at 16:38 Comment(7)
Can email clients run embedded Javascript? The OP says this is an email not a webpage on which the mailto: link will be.Acquittance
thanks, in Rails you can use the raw("text \n more text \n\n\t") function to encapsulate text and have this converted to line breaks and tabs for the email bodySecede
This worked for me, sending from a Chrome "mailto" to Outlook. Note that you must only encode the body text, not the entire mailto string; and you don't need spaces before/after the \n.Athwartships
I tried \b for bolding a text. It was not working. What are the other escape sequences supported?Clover
I liked this approach, here's a jsfiddle to see it in action: jsfiddle.net/oligray/5uosngy4Refurbish
You can also just use %0A for a linebreak, so you don't need to do it from JavaScript.Cherrylchersonese
In Rails 5, the u or url_encode methods will convert newlines and make your string generally URL-safe. https://mcmap.net/q/55627/-url-encode-equivalent-in-ruby-on-railsBeth
S
83

It's not quite what you want, but it's possible using modern javascript to create an EML file on the client and stream that to the user's file system, which should open a rich email containing HTML in their mail program, such as Outlook:

https://mcmap.net/q/55628/-use-javascript-to-create-an-html-email-in-microsoft-outlook

Here's a jsfiddle of an email containing images and tables: https://jsfiddle.net/seanodotcom/yd1n8Lfh/

HTML

<!-- https://jsfiddle.net/seanodotcom/yd1n8Lfh -->
<textarea id="textbox" style="width: 300px; height: 600px;">
To: User <[email protected]>
Subject: Subject
X-Unsent: 1
Content-Type: text/html

<html>
<head>
<style>
    body, html, table {
        font-family: Calibri, Arial, sans-serif;
    }
    .pastdue { color: crimson; }
    table {
        border: 1px solid silver;
        padding: 6px;
    }
    thead {
        text-align: center;
        font-size: 1.2em;
        color: navy;
        background-color: silver;
        font-weight: bold;
    }
    tbody td {
        text-align: center;
    }
</style>
</head>
<body>
<table width=100%>
    <tr>
        <td><img src="http://www.laurell.com/images/logo/laurell_logo_storefront.jpg" width="200" height="57" alt=""></td>
        <td align="right"><h1><span class="pastdue">PAST DUE</span> INVOICE</h1></td>
    </tr>
</table>
<table width=100%>
    <thead>
        <th>Invoice #</th>
        <th>Days Overdue</th>
        <th>Amount Owed</th>
    </thead>
    <tbody>
    <tr>
        <td>OU812</td>
        <td>9</td>
        <td>$4395.00</td>
    </tr>
    <tr>
        <td>OU812</td>
        <td>9</td>
        <td>$4395.00</td>
    </tr>
    <tr>
        <td>OU812</td>
        <td>9</td>
        <td>$4395.00</td>
    </tr>
    </tbody>
</table>
</body>
</html>
</textarea> <br>
<button id="create">Create file</button><br><br>
<a download="message.eml" id="downloadlink" style="display: none">Download</a>

Javascript

(function () {
var textFile = null,
  makeTextFile = function (text) {
    var data = new Blob([text], {type: 'text/plain'});
    if (textFile !== null) {
      window.URL.revokeObjectURL(textFile);
    }
    textFile = window.URL.createObjectURL(data);
    return textFile;
  };

  var create = document.getElementById('create'),
    textbox = document.getElementById('textbox');
  create.addEventListener('click', function () {
    var link = document.getElementById('downloadlink');
    link.href = makeTextFile(textbox.value);
    link.style.display = 'block';
  }, false);
})();
Stefaniastefanie answered 12/10, 2017 at 1:11 Comment(9)
Now that is a fancy ideaSniffle
Neat idea, but just for the record, on the latest Apple Mail, this file will open but won't be editable/sendable, it acts like a sent email recordSibyl
With Apple Mail (11.2), once you have opened the .eml file, you can select Message / Send Again from the menu (shift-cmd-D) to put the email in edit mode.Turfy
what about on android and iOS? i don't believe .eml files open unless you have a reader appDiet
This solution is explored on another similar question. However it turns out as @JamesBell mentions:Unpleasant update: Chrome (since about v.46) has begun flagging .EML files as possibly malicious. No idea what horrors a text file could cause but I assume they had their reasons. – James Bell Jun 29 '16 at 20:03Virnelli
does not work with Outlook 16 and FF 78 nor IE 11, but with Edge 90.Fabricate
I have a similar requirement and have followed this approach,however I have base64 encoded images in the email content.When the eml is generated the size of the image reduces. Below is the link created for same #67523617Northnortheast
Very cool - thanks for taking the time to write this answerDaleth
This will definitely work for our requirement. On Chrome 91 there was no info about eml files being malicious but on Edge 96 it shows a warning. The eml file works with Outlook version 2111.Furunculosis
A
74

I have used this and it seems to work with outlook, not using html but you can format the text with line breaks at least when the body is added as output.

<a href="mailto:[email protected]?subject=Hello world&body=Line one%0DLine two">Email me</a>
Affenpinscher answered 23/2, 2012 at 11:4 Comment(8)
So "%0D" is newline. What is an encoded tab's code equivalent?Acquittance
%0D is a newline which is ctrl-m, a tab is ctrl-i which is %09. Take a look at an ASCII chart like this [asciitable.com/index/asciifull.gif]. The control characters are from 1 through 31. @AcquittanceMaurene
Any signature seems to be removed when doing this.Tampere
%0A would be \nHaskell
That's not an HTML body!Isborne
Hex ASCII code for carriage return char, that's what %0D is. This is not HTML, but ASCII codesIlyse
Beautiful, also works inside confluence Insert Link on a page.Wadding
Works within Gmail web as well. Nice.Oestradiol
H
38

Some things are possible, but not all, say for example you want line breaks, instead of using <br />use %0D%0A

Example:

<a href="mailto:?subject=&body=Hello,%0D%0A%0D%0AHere is the link to the PDF Brochure.%0D%0A%0D%0ATo view the brochure please click the following link: http://www.uyslist.com/yachts/brochure.pdf"><img src="images/email.png" alt="EMail PDF Brochure" /></a>                        
Helsie answered 28/1, 2014 at 20:40 Comment(4)
That isn't HTML... still text.Astor
not if you format your email using $mailheader .= "Content-type: text/html; charset=iso-8859-1\r\n";Helsie
@StephenKaufman - you are not the one sending the email, but the clients who click the link. Meaning you don't know how the email client is set. You don't know how its headers are set. This will work on some email clients, and won't on others.Benghazi
thanks, this was the second best option for me, if I can't do html, then at least I can do carriage returns. fine by me.Starter
S
16

It is worth pointing out that on Safari on the iPhone, at least, inserting basic HTML tags such as <b>, <i>, and <img> (which ideally you shouldn't use in other circumstances anymore anyway, preferring CSS) into the body parameter in the mailto: does appear to work - they are honored within the email client. I haven't done exhaustive testing to see if this is supported by other mobile or desktop browser/email client combos. It's also dubious whether this is really standards-compliant. Might be useful if you are building for that platform, though.

As other responses have noted, you should also use encodeURIComponent on the entire body before embedding it in the mailto: link.

Swinger answered 17/5, 2012 at 14:38 Comment(2)
Yes, it does work perfectly to add simple bold, italic tags - in iOS anyway.Methacrylate
On iOS I cannot send correct email with <img src='mybase64'/> - in Gmail I see base64 inside my message.Occupational
H
14

Thunderbird supports html-body: mailto:[email protected]?subject=Me&html-body=<b>ME</b>

Headpin answered 5/9, 2019 at 21:57 Comment(1)
FWIW As of 2024, neither Apple Mail, Airmail, nor Gmail web client support this.Ebsen
O
1

Whilst it may not be possible within the parameter of the URL, there is a cheeky solution which allows full HTML. The concept is that you have a hidden element on the page (I am using Bootstrap and Jquery in the example below) which is temporarily revealed and the HTML copied (as per here: How to copy text from a div to clipboard). Following that, you redirect the user to the Mail link so in effect all they then have to do is hit Paste within their designated mail program. I've only tested this on Linux/Thunderbird but the paste also works into Gmail web.

<div id="copyEmailText" class="d-none"><p><strong>This is some HTML</strong>. Please hit paste when your email program opens.</p>

function copyDivToClipboard(element) {
    var range = document.createRange();
    range.selectNode(element);
    window.getSelection().removeAllRanges(); // clear current selection
    window.getSelection().addRange(range); // to select text
    document.execCommand('copy');
    window.getSelection().removeAllRanges();// to deselect
}

$('#copyEmail').on('click',function(){
    $('#copyEmailText').toggleClass('d-none');
    copyDivToClipboard($('#copyEmailText')[0]);
    window.location.href = 'mailto:?subject=Email subject text';
    $('#copyEmailText').toggleClass('d-none');
})
Oestradiol answered 29/7, 2022 at 13:19 Comment(1)
Hitting paste defeats the purpose of the mail link's body param.Tarshatarshish
T
0

Anybody can try the following (mailto function only accepts plaintext but here i show how to use HTML innertext properties and how to add an anchor as mailto body params):

//Create as many html elements you need.

const titleElement = document.createElement("DIV");
titleElement.innerHTML = this.shareInformation.title; // Just some string

//Here I create an <a> so I can use href property
const titleLinkElement = document.createElement("a");
titleLinkElement.href = this.shareInformation.link; // This is a url

...

let mail = document.createElement("a");

// Using es6 template literals add the html innerText property and anchor element created to mailto body parameter
mail.href = 
  `mailto:?subject=${titleElement.innerText}&body=${titleLinkElement}%0D%0A${abstractElement.innerText}`;
mail.click();

// Notice how I use ${titleLinkElement} that is an anchor element, so mailto uses its href and renders the url I needed
Twostep answered 12/6, 2019 at 21:7 Comment(0)

© 2022 - 2025 — McMap. All rights reserved.