Skip to content

{mailto}

{mailto} automates the creation of a mailto: anchor links and optionally encodes them. Encoding emails makes it more difficult for web spiders to lift email addresses off of a site.

Attributes

Attribute Name Required Description
address Yes The e-mail address
text No The text to display, default is the e-mail address
encode No How to encode the e-mail. Can be one of none, hex, javascript or javascript_charcode.
cc No Email addresses to carbon copy, separate entries by a comma.
bcc No Email addresses to blind carbon copy, separate entries by a comma
subject No Email subject
newsgroups No Newsgroups to post to, separate entries by a comma.
followupto No Addresses to follow up to, separate entries by a comma.
extra No Any extra information you want passed to the link, such as style sheet classes

Note

Javascript is probably the most thorough form of encoding, although you can use hex encoding too.

Examples

{mailto address="me@example.com"}
<a href="mailto:me@example.com" >me@example.com</a>

{mailto address="me@example.com" text="send me some mail"}
<a href="mailto:me@example.com" >send me some mail</a>

{mailto address="me@example.com" encode="javascript"}
    <script>
   eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b'))
</script>

{mailto address="me@example.com" encode="hex"}
<a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a>

{mailto address="me@example.com" subject="Hello to you!"}
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>

{mailto address="me@example.com" cc="you@example.com,they@example.com"}
<a href="mailto:me@example.com?cc=you@example.com,they@example.com" >me@example.com</a>

{mailto address="me@example.com" extra='class="email"'}
<a href="mailto:me@example.com" class="email">me@example.com</a>

{mailto address="me@example.com" encode="javascript_charcode"}
    <script>
    {document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))}
</script>

See also escape, {textformat} and obfuscating email addresses.