145

When trying to write an e-mail address, there are always problems with the @ sign.

Solutions I've seen suggested are using some verbatim environment (more difficult in footnotes) and using a math-mode @.

What is the correct way to do this?

3
  • Additionally you can redefine the arrobase (@) to be a different font and/or size. Thats why I do for my resume to make it really pop!
    – machinaut
    Jul 27, 2010 at 21:20
  • egreg's answer here is the way to go. Feb 4, 2014 at 14:28
  • If you dont need an actual link, use the 'url' package and the \url{} command. Jul 15, 2015 at 2:00

10 Answers 10

159

Another thing one can to with the hyperref package is to use the href command

\href{mailto:me@example.com}{me@example.com}

which has the advantage that when clicked-on in an electronic document, it will (ideally) call up the mailer and cue up the e-mail address.

8
  • 36
    I often define an \email command that expands to your \href, automatically prepending the mailto: part. Jul 27, 2010 at 7:53
  • 7
    Good idea. One small caveat is that <code>\email</code> is already defined in certain document classes (for example <code>amsart</code>). Jul 27, 2010 at 13:45
  • how do I do it in TexWorks ? it does not have hyperef, right ? How do I install hyperef in TexWorks ?
    – user25957
    Nov 29, 2013 at 20:47
  • 5
    @user25957 TeXWorks is an editor. It doesn't matter if you use TeXWorks, TeXShop, TeXMaker, TeXNicCenter, TeXLipse, Notepad, Emacs, Gedit, or whatever. It will always invoke the TeX distribution on your computer (TeX Live or possibly MiKTeX on Windows) which will most probably include hyperref.
    – marczellm
    Feb 4, 2014 at 13:35
  • 1
    For the lazy, @DamienPollet meant: use \newcommand{\email}[1]{\href{mailto:#1}{#1}} somewhere in your preamble, that'll do just fine.
    – Clément
    Mar 12, 2021 at 17:40
65

You can also combine the hyperref and url approaches to get a working link that is formatted like an URL:

\href{mailto:me@example.com}{\nolinkurl{me@example.com}}
26

Just to add to Willie's good answer, in terms of the formatting (as the OP seems to be getting at) there isn't a "correct" way. Use \textsf or \texttt or whatever looks good for your particular document and use case and font choice. Also try the randtext package to attempt to obfuscate the email address inside the PDF to make it less susceptible to spammers (but note that — I think — it doesn't play nice with hyperref's \href).

If you want to "special-case" the @ sign without adding markup to your text, you could write something like this:

\documentclass{article}
\usepackage{color,hyperref}
    \catcode`\_=11\relax
    \newcommand\email[1]{\_email #1\q_nil}
    \def\_email#1@#2\q_nil{%
      \href{mailto:#1@#2}{{\emailfont #1\emailampersat #2}}
    }
    \newcommand\emailfont{\sffamily}
    \newcommand\emailampersat{{\color{red}\small@}}
    \catcode`\_=8\relax    
\begin{document}
\email{foobar@gmail.com}
\end{document}

where you get the proper hyperlinking of the email address and you can customise the look of the email by changing \emailfont and the look of the ampersat (or arrobase, or @) by changing \emailampersat.

1
  • 1
    Yeah.. mentioning randtext was exactly what I needed. Just curious... does your command still produce a working hyperlink if I wrap a randtext{} around it? I suppose not... Jun 4, 2017 at 9:48
17

You can define \at command in the preamble:

\newcommand{\at}{\makeatletter @\makeatother}

and then use it as follows within the document:

myemail\at gmail.com
1
  • 7
    The catcode of @ in \at is the catcode that was set for @ at the time of the definition. If the catcode of @ should be "letter", then it is defined via \makeatletter\newcommand*{\at}{@}\makeatother. However, the catcode "letter" or "other" does not matter here, thus \newcommand*{\at}{@} would be enough or just using @. Feb 4, 2014 at 15:26
14

Very simple solution from here:

\texttt{john@gmail.com}

1
  • The curly grouping braces around @ are not needed. Mar 18, 2018 at 1:38
11

If you don't like how the at-symbol of the default font looks (I don't), you may borrow it from the Times font, like so: youraddres{\fontfamily{ptm}\selectfont @}example.com

0
4

For the @ character I prefer the \MVAt command from the marvosym package, since the cmss @ looks so different from other fonts I'm used to. For the full address I use the hyperref formatting suggested by Willie.

3

I don't think that there is a unique correct way to handle this. As another answer says, you can use hyperref. But, the url package can also be used to render email addresses:

\documentclass{article}

\usepackage{url}

\begin{document}

\url{me@example.com}

\end{document}
4
  • 1
    You don't want to use \url because it will attempt to create a hyperlink to an actual URL with the email address you supply. See Caramdir's answer for a better solution. Aug 18, 2010 at 10:11
  • 1
    @WillRobertson: You sure about that? Note that this was \url from the url package, not from hyperref.
    – vanden
    Aug 18, 2010 at 15:10
  • 4
    Oops; I meant only if you load hyperref as well -- it will transparently replace \url with the hyperlinked one. The point is that \url is not semantically designed for email addresses. Aug 19, 2010 at 3:32
  • Logical markup can be defined with package url via \DeclareUrlCommand\email{} and used as \email{me@example.com}. Feb 4, 2014 at 15:29
3

I defined a command, to avoid the redundancy of Willie Wong's and Caramdir's answers, and to allow protocols other than mailto:

\usepackage{hyperref}
\usepackage{xstring}

\newcommand{\thelink}{\@empty}
\newcommand{\link}[2]{%
  \IfSubStr{#1}{:}{\renewcommand\thelink{#1}}{\renewcommand\thelink{#1:#2}}%
  \href{\thelink}{\texttt{#2}}%
}

There's a long form, where the URL is different than the text, and the short form, where the protocol is catenated with the text to make up the URL:

Phone: \link{tel:1234567890}{+1 234-567-890} \\
E-mail: \link{mailto}{foo@bar.spam}

Produces this result:

latex rendered output

I use \texttt instead of \nolinkurl, because the latter removed spaces from the supplied text.

1

There are a number of things that you can try:

(with the hyperref package):

\url{email address}

or more simply (for monospace font):

\texttt{email address}

1
  • 5
    You don't want to use \url because it will attempt to create a hyperlink to an actual URL with the email address you supply. See Caramdir's answer for a better solution. Aug 18, 2010 at 10:10

Not the answer you're looking for? Browse other questions tagged or ask your own question.