Configuring your Confluence server to send email messages allows your Confluence users to:
You can personalise email notifications by configuring the 'From' field to include the name and email address of the Confluence user who made the change.
You need System Administrator permissions in order to configure Confluence's email server settings.
Configuring Confluence to send email messages
To configure Confluence to send outgoing mail:
- Choose the cog icon at top right of the screen, then choose Confluence Admin.
- Select Mail Servers under Configuration in the left-hand panel. This will list all currently configured SMTP servers.
- Click Add New SMTP Server (or edit an existing server).
- Edit the following fields as required:
- Name: By default, this is simply 'SMTP Server'.
- From Address: Enter the email address that will be displayed in the 'from' field for email messages originating from this server.
This field is mandatory. You will not be able to complete the Confluence mail server configuration until this field has been specified.
From Name: Enter the name that will be displayed in the 'from' field for email messages originating from this server. This is the text which appears before the user's registered email address (in angled brackets).
This field accepts the following variables, which reference specific details defined in the relevant Confluence user's profile:
The user's full name.
The user's email address.
The domain/host name component of the user's email address.
The default is '
Hence, if Joe Bloggs made a change to a page he was watching and the Confluence site's 'From Address' was set to
email@example.com, then the 'From' field in his email notification would be:
Joe Bloggs (Confluence) <firstname.lastname@example.org>.
- Subject Prefix: Enter some text to appear at the beginning of the subject line.
- Manually enter your Host Address, User Name and Password details (recommended)
Specify the JNDI location of a mail session configured in your application server. For more information on how to set up a JNDI mail session, see Setting Up a Mail Session for the Confluence Distribution.
Testing the email settings
A Confluence administrator can test the email server as follows:
- Set up a mail server at Confluence Admin > Mail Servers, as described above
- Click Send Test Email to check that the server is working. Check that you get the test email in your inbox.
- You can flush the email queue to send the email message immediately. Go to Confluence Admin > Mail Queue, and click Flush Mail Queue. See The Mail Queue.
A user can test that notifications are working as follows:
- Go to your user profile (using the Settings link) and edit your email preferences. See Subscribing to Email Notifications of Updates to Confluence Content.
- Enable Notify On My Actions. (By default, Confluence does not send you notifications for your own changes.)
- Go to a page you wish to get notifications about.
- Choose Tools > Watch. See Watching Pages, Spaces and Blogs.
- Edit the page, make a change, and save the page.
- Check your email inbox. You may need to wait a while for the email message to arrive.