Import your spaces and pages from Confluence into a ClickUp Doc.
Feature availability and limits vary by plan and user role. Learn more
There is a file size limit of 2.5GB. The import may take some time, depending on the size of your data and the speed of your internet connection.
Prepare your import file
To prepare your import file:
- Log in to Confluence.
- In the Confluence sidebar, click Space Settings.
- In the Manage Space section, click Export space.
- Under Export Formats, select HTML.
- Click Next.
- Select Normal Export.
- Click Export.
- When the export is complete, click the Download here button to download the contents in a zip file.
Import spaces and pages to ClickUp
You can import from Confluence from multiple locations in ClickUp:
- The Import/Export page, located in your Workspace settings. Your new Doc will be created in Docs Hub.
- Your Home Sidebar. Your new Doc will be created in the selected location.
- The Spaces Sidebar. Your new Doc will be created in the selected location.
As part of the import process, you'll need to sign in and export from Confluence. The instructions below include the steps you'll take in Confluence.
From Workspace settings
To import from Confluence from the Import / Export page:
- In the upper-left corner, click your Workspace avatar and select Settings.
- In the All settings sidebar, select Imports / Exports.
- If your Workspace doesn't have an import or export history, the Select source of import page opens. In the Import from apps section, select Confluence.
- If your Workspace has an import or export history, the Imports / Exports page opens. Select Import items.
- On the Confluence import preparation page, follow the instructions, then click Next.
- Drag and drop the unzipped export file or use the file browser to upload your file.
- Once the upload is complete, click Next.
From the Sidebar
To import from Confluence from the Sidebar:
- In your Home Sidebar or the Spaces Sidebar, hover over a Space, Folder, Subfolder, or List.
- Click the ellipsis ... menu.
- Click Create new.
- Select Import.
- Choose Confluence.
- On the Confluence import preparation page, follow the instructions, then click Next.
- Drag and drop the unzipped export file or use the file browser to upload your file.
- Once the upload is complete, click Next.
After importing from Confluence
After your import is complete, a Doc with the imported content will be available in Docs Hub.
By default, all of your imported content will be shared with your entire Workspace. You can make your Doc private to share it with specific people or teams.
You can move any pages you wish to keep private into separate Docs and edit sharing permissions for each Doc.
Learn more about using Docs in ClickUp, including:
- Create visually stunning content with rich text formatting.
- Use columns, tables, and content blocks to organize content on pages.
- Organize your docs with Doc tags.
- Convert your doc into a wiki to make the content easy to find for your team.
- Protect Docs and pages to prevent accidental edits.
- You can publicly share Docs and pages to the web.
- Create and apply Doc templates to keep a consistent structure across Docs and pages.
Current coverage is summarized below
- * * * * * * * * * * * Draw.io
What imports and what doesn't
The following coverage is based on current workspace migration analysis and SME testing notes. Confluence Data Center exports may differ from the Cloud exports used in some tests, so validate a representative sample space before migration.
| Item | Current behavior |
| Pages and subpages | Imports as one ClickUp Doc with subpages. |
| Inline images | May import as images backed by URLs to the original Confluence system; hosting in ClickUp is not guaranteed. |
| Non-image attachments, including PDFs | Inconsistent. Some attachments import, while others remain as original or dead links; attachments inside table cells are not supported. |
| Panels | Not supported consistently and may not render as ClickUp Banners. |
| Expands | Not supported consistently and may not render as ClickUp Toggle Lists. |
| Columns | Confluence layout is not retained. |
| Table of Contents macro | Imports as unusable anchor links rather than a functional TOC. |
| Status, decision, and date macros | May not import in the same format. |
| User mentions | Import as links to the source system rather than mapped ClickUp users. |
| Page metadata | Author, contributors, dates, and similar metadata are not exported. |
| Labels | Not exported. |
| Header images, icons, and emoji | Not exported. |
| Draw.io and Gliffy diagrams | Inconsistent. Image-converted diagrams may import, while attachment-based diagrams may not. |
| Whiteboards and databases | Not exported by Confluence or not supported by the current import path. |
| Comments | Not exported by the Confluence HTML export and cannot be imported. |
| Links and section jump links | Cross-space or external links remain pointed at the source; section jump links are unusable. |