Export in Confluence

The Confluence importer works by processing a HTML export from a Confluence space. These exports are reasonably high fidelity and can be created in hosted or on-premise Confluence installations.

You can generate an export in Confluence by going to Space Settings → Manage space → Export space. Choose HTML as the format and follow the steps until a zip file is generated. You can uncompress the zip file and see the content in a regular web browser by opening the index.html, this will give you a good estimation of the content that is available to Outline.

Import in Outline

In Outline navigate to Settings → Import → Confluence and choose the zip file you exported – at this time there are no additional settings. You can monitor the import progress from the settings screen, it will usually complete in moments.

The import dialog

Supported content

• Text content and formatting such as italic, bold, underline

• Links

• Lists, numbered lists, check lists

• Notices (Info / error / etc)

• Code blocks

• File attachments

• Embedded images

• Document nesting

• Emojis

• Simple tables

Unsupported content

• Macros

• Confluence plugins

• Multi-column layouts

• Comments

• Authorship

Troubleshooting

If the import fails it will usually be because the export is too large, you must change the settings in your environment (FILE_STORAGE_WORKSPACE_IMPORT_MAX_SIZE) to increase the maximum file size for uploads.

If the upload hangs on processing it may have run out of memory, ensure your server has enough memory to unzip the entire export.