Access Keys:
Skip to content (Access Key - 0)

Adaptavist Documentation Move

This documentation is deprecated. Adaptavist's documentation has moved to a new location where it is maintained and updated. Please visit Adaptavist's new Documentation area.

form-mail macro


The {form-mail} macro adds a simple, no-frills email form you to your content...

Although it's easy to add links to email addresses, the {form-mail} macro has the following advantages:

  • Reduce liklihood of getting spam because the email address isn't output while viewing the page
  • Allow people to send you emails even if they are not at their own computer, for example when they are in an internet cafe so they don't have their own email client.
  • Ensure that key details are provided such as the senders name and email address, a subject and the message body (warnings are shown if any item is missing)
  • Automatically fill in sender's name and email address if they are logged in to Confluence
  • Display a custom message (if desired) after the email has been sent – this is ideal if you need to ask people to add your email domain to their Spam filter's whitelist to ensure any replies you send get through.


To add the email form, use the following notation:

Message to display when the email has been sent.
Parameter Required Default Notes
to   The recipient of the email, specified as either their email address or, if they have a user account within Confluence, their user name prefixed with a tilde (e.g. ~gfraser)


See Also:

View old comments

Adaptavist Theme Builder Powered by Atlassian Confluence