Importing Mail

Confluence allows you to import mail from mbox files located either on your local system or in a specified location on the Confluence server. Confluence will store the imported email messages in the space's mail archive.

You need to be a space administrator to import mail for a space. See Space Permissions.

NB: You may need to enable the Confluence Mail Archiving Plugin as it is disabled by default.

To import mail from an mbox file:

  1. Go to the space and choose Space tools > Integrations on the sidebar.
  2. Choose Mailbox Import.
    • To import from a location on your file system: Browse to the location of the mbox file, select the file and then choose Import.
    • To import from the Confluence server: Enter the location of the mbox file on the server, then choose Import.

If your space uses the Documentation theme:

  1. Choose Browse > Space Admin at the top of the screen.Note: The 'Space Admin' option appears only if you have space admin permissions for the space or you have System Administrator global permissions.
  2. Choose Mailbox Import in the space administration options.
    • To import from a location on your file system: Browse to the location of the mbox file, select the file and then choose Import.
    • To import from the Confluence server: Enter the location of the mbox file on the server, then choose Import.

(warning) The information on this page does not apply to Confluence Cloud.

  • Only site spaces can store mail archives. Personal spaces cannot. See Working with Spaces for an explanation of site spaces and personal spaces.
  • Confluence mail archiving is an optional feature. This means that the 'Mail' options may be disabled and will therefore not appear in the Confluence user interface. Mail archiving features are contained in a bundled plugin. To activate mail archiving features in Confluence, enable the plugin – choose  > General Configuration > Manage Add-ons. Then choose System in the drop down, and enable the Confluence Mail Archiving Plugin.
  • For security reasons mail can only be imported from a specified location in the Confluence server's file system.  We recommend administrators create a folder in their Confluence home directory, add the system property confluence.mbox.directory and specify the location for mailboxes to be imported from. Mail cannot be imported from the server until this system property is set. See Configuring System Properties.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport