• Documentation

Import data from Notion into Confluence

The Notion Importer is currently in Beta and will undergo further enhancements and simplification in upcoming releases. If you'd like to learn more about its limitations, feel free to visit our FAQ.

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

You must be a Notion workspace owner and a Confluence organization or site admin to initiate the import process.

Upload Notion content

To import content from Notion, you need to select the desired workspace or page with subpages, similar to exporting in Confluence. The process involves authorizing access and choosing between exporting the entire workspace or a selected page.

Notion can only export the content you can access. Learn more about exporting from Notion

The steps for importing an entire workspace or a selected page (with children pages) are similar.

To select the content you want to import from Notion:

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

  2. Select Notion.

  3. Select one of the two options:

    1. Entire Notion workspace - This is the equivalent of exporting a space in Confluence.

    2. Selected page with subpages - This is the equivalent of exporting a single page, or a page with child pages in Confluence.

  4. Upload your Notion zip file.

  5. Select Next.

You can continue to the next step while the file is uploading in the background. Want to know more about how your content will look? Visit our FAQ page

Transfer users

Map Notion members to their Confluence profiles

To export certain page and user data, you need to log in with OAuth authentication and create an access token. OAuth authentication allows the importer to map users from Notion and Confluence, mapping users on elements like @mentions, page comments, creator, and editor information.

If you don’t want to map Notion users, you can deselect the toggle, select Next, and skip ahead to the Set up spaces section.

To retain comments, @mentions, and more, log in to your Notion account:

  1. Select Log in to Notion.

  2. Enter your log in information, then Select pages. (Make sure that they are the same pages that you exported in your file.)

  3. Select each checkbox for the content you want to transfer, then Allow access.

    1. Ensure that you are selecting the same content in the OAuth step as the content you have uploaded in your Notion file.

If you want to create Confluence accounts, enable the Add remaining members to Confluence toggle.

Add remaining members to Confluence

Enable the Add remaining members to Confluence toggle to create Confluence accounts for any Notion members that don’t already have one so we can add their names to pages, comments, and @mentions.
Note: New users won’t automatically receive an email invite to join. Here’s how to send them an invite

Adding users can affect your plan and may result in additional fees. They’ll be added to your plan immediately after you start the import. Check out our FAQ for information about user and storage limits

Copy Notion page permissions

To transfer permission and user group data, you need an access token.

You may see slightly different steps depending on which browser you use.

Permissions map to the time when you select Start import, not when you upload your Notion file.

To create an access token:

  1. Select Add an access token.

  2. Go to www.notion.so in your browser (make sure you are logged into just one account).

  3. Right-click anywhere on the screen and select Inspect Element to open Developer tools.

  4. Go to the Storage tab.

  5. In the sidebar, select the ⏵ toggle next to Cookies folder to expand it.

  6. Select www.notion.so.

  7. Find the entry named token_v2 and double-click on it to open details.

  8. Select the text in the Value field, then copy it (Cmd/Ctrl + C).

  9. Paste this token into the Notion access token text box, then select Submit.

Set up spaces

Each Notion teamspace will become a Confluence space. Set the permissions to determine who can access them. Additionally, private content is added to a new, restricted space.

To configure your new spaces:

  1. If you’re importing pages only (not an entire workspace), enter a name for the new space in Confluence.

  2. Select the restrictions to apply to all spaces:

  • Restricted to you - 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).

  • 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.

  • Notion permissions - apply the equivalent restrictions from your Notion workspace or pages to the newly created content. Note: This space restriction option is only available if you select “Copy Notion page permissions” in the previous Users step.

  1.  Select Next.

Review and start the import

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.

Review the notification email

When the process is complete, you’ll receive an email summary from the importer.

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 Notion 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.

Note: New users won’t automatically receive an email invite to join. Here’s how to send them an invite

Still need help?

The Atlassian Community is here for you.