• Documentation

Import data from HTML to Confluence

You can import your content from HTML into Confluence spaces with our new importing tool. This guide outlines the process of importing your content from HTML. Additionally, you can find detailed information on what content gets transferred and how it will look in Confluence.

You must be a Confluence org or site admin to initiate the import process.

Upload HTML content

To import content from HTML, verify that you first have permission to create a space. To select the content you want to import from HTML:

  1. In Confluence, select Spaces from the top navigation, then Import from other tools.

  2. Select HTML.

  3. Upload your HTML Zipfile.

  4. Select Next.

Your file will be uploaded in the background. Want to know more about how your content will look? Check out our FAQ.

Set up space

To configure your new space:

  1. Enter a name for the new space in Confluence.

  2. Select the restrictions to apply to the new space:

  • Default space permissions - apply your organization’s default restrictions. Note: If your organization uses open permissions by default, private content may be exposed. If you’re unsure, use Restricted to you and then update the restrictions after the import.

  • Only visible to me - only you will be able to view and access the content. Note: because only you will be able to access the content, all pages and comments will be labeled as created by you (the importing user).

  •  Select Next.

Review the notification email

You’ll have a chance to review everything before you start the import process. Make sure everything looks correct. Select a step to edit anything that doesn’t look correct.

After the upload is complete, select Start import. This process can take a while. Depending on the complexity, bandwidth, size of the transfer, and other factors, it can take a few hours or more to finish. You will receive a notification email when the import is complete.

This process can take a while. Depending on the complexity, bandwidth, size of the transfer, and other factors, it can take a few hours or more to finish.

Congratulations! You’ll receive a notification email confirming the transfer is complete. You successfully imported your HTML content and can get started right away. If you encounter any errors or failure notifications in the email, read our troubleshooting article for common fixes.

Still need help?

The Atlassian Community is here for you.