Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

How can i create a link to create an email with a subject



My target is, that a user can create an email with a defined receiver and a defined subject with one click.

I am using Confluence 5.10.8

The solution to create a new email is very easy. 


Insert -> Link, enter the email adress and i have my link including the mailto-function.


Now i want to use the mailto-function including a subject like on this page

Unfortunately i don't know how to add this macro 

"<a href="">linkname</a>"

into confluence.

And i don't know how to use the " report macro" from the second link in this questions, because i can't find this macro.

Does someone have an idea with perhaps some screenshots?

Thank you in Advance!


2 answers

2 votes
Shannon S Atlassian Team Nov 08, 2017

Hi Jürgen,

The example you gave works.

Screen Shot 2017-11-08 at 3.46.42 PM.png

Essentially, you just write your text on the Confluence page, highlight it, click Insert Link, and choose Web link. Then you can paste this in the address:

Then, when clicking that link in the saved page, it automatically opens an email window with the recipient and the subject already filled in. I've tested this in Confluence 6.5.0.

In terms of the Reporting Macro, I'm not really sure what Heidi is referring to. It could possibly be the Reporting Macro from ServiceRocket.

Kind Regards,

I tried this on Confluence Cloud.  It worked while I was in Edit mode but as soon as I published, the link got scrubbed.  I don't know if it matters, but I was setting both a subject and a body.

On Confluence Cloud, I've been able to set the `subject` but when I add `body` the link is lost and you are left with blue underlined text. In the editor you can create a link like this:`` but as Derek mentions above, it fails silently and rather inelegantly during publishing.

Perhaps worth noting, you don't need to explicitly add `%20` for spaces, when creating the links, Confluence will insert them for you. 

Like Yuriy Buha likes this

Yes, same here. Adding body and testing before saving works great, but after saving it, the link no longer works and it is just a formatted string

none of this works

Hello Conrad,

Welcome to Atlassian Community. It's nice to meet you.

The specific instructions on this thread are for Confluence Server as it was 2 years ago, but the idea is still the same for Confluence Cloud.

I've created a video below that will help you to do this in Cloud on the new editor, as I suspect this is what you are using.

Could you give this a try and let me know if it works?



Like # people like this

What about multiple recipients, and the body issue?

Hi Daniel,

My apologies, I missed when @Derek Price and @BenJoaquin Gouverneur mentioned this issue.

I'm using the new editor, and I just formatted my link like this, and it works:

CleanShot 2019-12-11 at 11.42.19.png;

When I click this link, it opens up the email like this, which looks right to me:

CleanShot 2019-12-11 at 11.40.36.png 

Can you let me know how that goes?



Like Rickson Kuriakose likes this

Hi @Shannon S 

is there a way to add a variable in the mailto link so the subject is dynamic and writes the page title? I don't want static text as in the example you provided

Shannon S Atlassian Team Jan 17, 2020

Hi @Nour Durra Nagarro,

Thank you for following-up on this thread. It's not possible to use variables in the Link Macro, and would likely require writing a User Macro which is only possible in Confluence Server.

You could also check out some of the various add-ons available from Atlassian Marketplace. There may be one available that can help you with this requirement.



@Shannon S  Is it possible to create a macro, like in the video above, but for an email with Subject and Body static text but no recipients (which can be added once the email is linked to)?

Shannon S Atlassian Team Jul 07, 2020

Hi @Mia Gaventa,

I believe that may indeed be possible, but I unfortunately don't have much practice myself in writing User Macros. You could ask this as a new question in the Confluence collection, and some of our more experienced User Macro writers will be able to help you out!


Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

An update on Confluence Cloud customer feedback – June 2022

Hi everyone, We’re always looking at how to improve Confluence and customer feedback plays an important role in making sure we're investing in the areas that will bring the most value to the most c...

273 views 2 5
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you