send-email macro

Overview

The send-email macro is used to send custom email notifications to one or more recipients.

Where to use it?

Optional.

One or more send-email macros can be put in a trigger macro.

Parameters

Parameter	Required	Default	Notes

Parameter	Required	Default	Notes
macro body			The body of the email: Plain text, or Wiki markup – see Confluence Wiki Markup Can use any character set supported by your Confluence server – except some reserved characters Supports Value References When using the `send-email` macro in a trigger initiated by an expiration event, page or space reference links (when the page title is set between [ ] to generate a link from it) are not supported. However regular links wiki markup, for example, [google\|https://google.com] do work.
macro body			Complex wiki markup (eg. macros) may not degrade nicely to `text/plain` MIME type.
`address`	See below.		A list of one or more email addresses to send the email to: Comma-separated list of email addresses Supports Value References (v4.5.2+) Filter by label There are no items with the selected labels at this time.
`mimetype`		`text/html` Or, if set, users' preferred format.	Which email format to send? `text/html` – force HTML format `text/plain` – force plain text format Page: Adding page activity to email
`subject`			Email subject: Plain text Supports Value References Page: Adding page activity to email Page: Scaffolding app - Retrieve list-data via supplier reference
`user`	See below.		A list of one or more users to send the email to: Comma-separated list which can contain: Usernames User groups Supports Value References Alternatively, set to `watchers` to email everyone watching the page or blog post associated with the workflow. Page: Adding page activity to email Page: Scaffolding app - Retrieve list-data via supplier reference
Either a user or an address parameter must be specified for the macro.

App configuration

Setting	Where	Notes

Setting

Where

Notes

From Address

From Name

Mail Servers - Global

The "From" email address and name are set in → General Configuration → Mail Servers.

Notification settings

When using custom emails, check to see if they are duplicating any of the in-built emails sent by the app - if so, you can disable them in the notification settings at either Space or Global level.

Email Any Address

Configuration - Global

If disabled, emails listed in the address parameter can only be sent to if they are associated with registered user accounts (those in the confluence-users user group).

Example

{workflow}
   	{state:Test|approved=Published}
      {approval:Review}
   	{state}
   	{state:Published}
   	{state}
   	{trigger:pageapproved|approval=Review|partial=true}
      {send-email:user=@user@|subject=Document approved}
         Thank you for approving @page@!
      {send-email}
 	{trigger}
	{trigger:statechanged|state=Published}
      {send-email:user=watchers|subject=Document Published}
          @page@ was published! See what's new!
      {send-email}
   	{trigger}
{workflow}

Related examples

Page:

Adding page activity to email — Include page activity report, or a link to it, in custom email notifications
Page:

Scaffolding app - Retrieve list-data via supplier reference