After you have successfully installed the add-on you will need to make a few basic configuration settings before you can send your first email to Confluence.

To follow this guide you will need administrative rights. If you are not a Confluence Administrator you will need to ask a Confluence admin of your organization to do the steps for you.

Go to the Confluence Welcome Page or any other page in Confluence. In the menu bar at the top right of your screen click on the Settings icon. Then select Manage apps from the drop-down.

This will take you to an overview page which shows all of your currently installed add-ons. Find the mailto.wiki - Email for Confluence add-on and expand the section by clicking on the title. Then click on the Configure button to go to the configuration page for the add-on.

You should now see the configuration page for the add-on.

Before you can send your first email, you will have to do three things: set up your email server connection information, set the default space and the default content type.

Every email that you send to your registered email account will be automatically inserted into your default space as page or blog post, depending on what you configured as default content type. You can think of the default space as your INBOX.

First, you need to set up the email server connection information. For this purpose, an email account must be created, to which the emails can be sent later. We strongly recommend using this account only with mailto.wiki. Since mailto.wiki accesses the email account, unexpected behavior may occur, if you try to use the account for other purposes in parallel. 

After you have created an email account, you need to fill in the server and account information. You can see an example in the picture below.

After you have filled in the server information, click on one of the two Save Settings buttons. After a few seconds, a window will pop up in the upper part of the settings, indicating whether mailto.wiki was able to successfully connect to the email account or not. In case of failure, a detailed error message will be displayed here. If this is not enough to solve the problem by yourself, please contact us at support@mailto.wiki. In case of success, you can continue with the settings.

After you registered at least one email address successfully you are able to Email for Confluence. As already mentioned these get inserted in the default space. As the default space is set automatically during installation make sure to change it to a space of your choice.

Finally you need to select a default content type. Confluence knows two types of contents: Pages and blog posts. Atlassian states that pages are great for when you want the information to last and evolve over time. If it's a point-in-time update or one-time communication then a blog post is the way to go.

You are now ready to send your first email to Confluence. Open your email program or log into your web-mail provider. Then write an email to the email account you registered above.

After sending your email wait 5 minutes to give the system time to process your message and go to the default space you configured above. If you configured everything correctly the message will appear in the default space as page or blog post depending on your settings for the default content type.

You are now ready to Email for Confluence. Try it out and if errors occur or something does not work as expected, don't hesitate to contact us at our Help Desk or via email at support@mailto.wiki. If you want more control over where your emails get posted, you can use Space Rules.