View source for Template:Email/doc

{{tsh | e-mail | email address}}
The '''{{tld | email}}''' template creates a link to an email address, showing either the e-mail address itself or replacement text (typically the name of the person to be emailed), followed by an icon to highlight that it is an external link. 

{{tlx|Email|{{xt|address}}}} produces the same result as {{code | <nowiki>[Mailto:</nowiki>{{xt|address}}  {{xt|address}}]}}:
* {{tlx |Email | John.Doe@gmail.com}} → {{Email | John.Doe@gmail.com}}
* {{code | <nowiki>[Mailto:</nowiki>John.Doe@gmail.com John.Doe@gmail.com]}} → [Mailto:John.Doe@gmail.com John.Doe@gmail.com]

You may make a link that sends an email to multiple addresses by entering multiple addresses separated by semicolons, such as {{tlx|Email | {{xt|John.Doe@gmail.com;Jane.Smith@science.doe.gov}} | {{xt|John and Jane}}}}, which would result in {{Email | John.Doe@gmail.com;Jane.Smith@science.doe.gov | John and Jane}}.

==Parameters==
{| class=wikitable
! Parameter !! Description !! Notes
|- valign=top
| {{Para | address}} || The email address to link to. || ''Required''. The {{para | address}} may be omitted if this is the first unnamed parameter.
|- valign=top
| {{para | name}} || Name to use as the link text instead of displaying the email address. || ''Optional''. The {{para | name}} may be omitted if this is the second unnamed parameter.
|- valign=top
| {{para | sort}} || Enter the name in {{xt | last name, first name}} order (or whatever other sort basis you prefer) if it is being used in a sortable table. || ''Optional''. The {{para | sort}} may be omitted if it is the third unnamed parameter.
|}

==Examples==
{| class=wikitable
! What you type !! Results
|- valign=top
| {{tld | email | John.Doe@gmail.com}} || {{email | John.Doe@gmail.com}}
|- valign=top
| {{tld | email | Jane.Smith@science.doe.gov}} || {{email | Jane.Smith@science.doe.gov}}
|- valign=top
| {{tld | email | name{{=}}James Johnson | address{{=}}JohnsonJ@nnsa.doe.gov}} || {{email | name=James Johnson | address=JohnsonJ@nnsa.doe.gov}}
|- valign=top
| {{tld | email | JohnsonJ@nnsa.doe.gov | James Johnson}} || {{email | JohnsonJ@nnsa.doe.gov | James Johnson}}
|}


===Sorting===
Click the up and down triangles after the column header in the second column to compare how the first table sorts by first name and the second by last name.
{| class=wikitable
! colspan=2 | Without {{para | sort}}
|- valign=top
| 
{{pre | <nowiki>
{| class=sortable 
! Names
|-
| {{email | charlie.indigo@gmail.com | Charlie Indigo}}
|-
| {{email | Name=Roger Queen | Roger.Queen@gmail.com}}
|-
| {{email | address=Pete.King@gmail.com | name=Peter King}}
|-
| {{email | Address=george.love@gmail.com | Name=George Love}}
|-
| {{email | Michael.Baker@gmail.com | name=Mike Baker}}
|-
| {{email | name=William Fox | address=Bill.Fox@gmail.com }}
|}</nowiki>}}
| 
{| class=sortable 
! Names
|-
| {{email | charlie.indigo@gmail.com | Charlie Indigo}}
|-
| {{email | Name=Roger Queen | Roger.Queen@gmail.com}}
|-
| {{email | address=Pete.King@gmail.com | name=Peter King}}
|-
| {{email | Address=george.love@gmail.com | Name=George Love}}
|-
| {{email | Michael.Baker@gmail.com | name=Mike Baker}}
|-
| {{email | name=William Fox | address=Bill.Fox@gmail.com}}
|}
|-
! colspan=2 | With {{para | sort}} 
|- valign=top
| 
{{pre | <nowiki>
{| class=sortable 
! Names
|- 
| {{email | charlie.indigo@gmail.com | Charlie Indigo | Indigo, Charlie}}
|-
| {{email | Name=Roger Queen | Roger.Queen@gmail.com | Sort=Queen, Roger}}
|-
| {{email | address=Pete.King@gmail.com | name=Peter King | sort=King, Peter}}
|-
| {{email | Address=george.love@gmail.com | Name=George Love | Sort=Love, George}}
|-
| {{email | Michael.Baker@gmail.com | name=Mike Baker | sort=Baker, Mike}}
|-
| {{email | sort=Fox, William | name=William Fox | address=Bill.Fox@gmail.com}}
|}</nowiki>}}
| 
{| class=sortable 
! Names
|-
| {{email | charlie.indigo@gmail.com | Charlie Indigo | Indigo, Charlie}}
|-
| {{email | Name=Roger Queen | Roger.Queen@gmail.com | Sort=Queen, Roger}}
|-
| {{email | address=Pete.King@gmail.com | name=Peter King | sort=King, Peter}}
|-
| {{email | Address=george.love@gmail.com | Name=George Love | Sort=Love, George}}
|-
| {{email | Michael.Baker@gmail.com | name=Mike Baker | sort=Baker, Mike}}
|-
| {{email | sort=Fox, William | name=William Fox | address=Bill.Fox@gmail.com}}
|}
|}

<includeonly>
{{sandbox other||
[[Category:Templates with TemplateData]]
}}
</includeonly>