In response to this tweet:

Does anyone know how to create a “mailto” link that dynamically contains the Pagetitle and URL of a page in #Confluence? #atlassian #wiki

— Confluence Fan (@confluencefan) January 26, 2012

here’s how to create a Confluence User Macro which will create a “mailto” link which dynamically has the page title as the subject of the email and the page title and URL of the page in the body of the email.

1. Log in to Confluence as a Confluence Administrator

2. Select Browse -> Confluence Admin -> User Macros

3. Create a new User Macro:

Template:

## Macro title: Mail To
## Macro has a body: N
## Body processing: Selected body processing option
## Output: Selected output option
##
## Developed by: Andrew Frayling
## Date created: 26/01/2012
## Installed by: My Name

## Simple Mail to macro which constructs a <a href=mailto:> link
## with the page title as the subject and the page title and URL of
## the page as the body
## @param email:title=Email Address|type=string|required=true

<a href="mailto:$paramemail?subject=Page Title: $renderContext.getPageTitle()&body=This is the page I am mailing you from: $renderContext.getPageTitle() - $action.getGlobalSettings().getBaseUrl()$content.getUrlPath()">Click to Email Me</a>

The variables in the template are:

@param email:title=Email Address|type=string|required=true – prompts the user for an email address that they would like the mailto link to send the email to

$renderContext.getPageTitle() - retrieves the title of the page that the macro is inserted into

$action.getGlobalSettings().getBaseUrl() – retrieves the base URL of the Confluence install

$content.getUrlPath() – retrieves the URL path of the page that the macro is inserted into

Therefore the full URL of the page is $action.getGlobalSettings().getBaseUrl()$content.getUrlPath()

4. Save the user macro

Now when you edit a page you can use the wiki markup:

{mailto:email=joebloggs@example.com}

where joebloggs@example.com is the email address of  where you would like the mailto link to send the email, or select the macro from Insert -> Other Macros

Which will give you the following link on a page:

Clicking the link will result in an email being composed in your default email client:

I did spend some time trying to get the URL in the email to be rendered as a clickable <a href> link, but a URL within a URL didn’t want to play ball.

Share