Import Confluence Content into ClickUp

Bringing your existing workspace into ClickUp is simple when you use the built-in Confluence importer. This guide walks you through every step to move pages, spaces, and attachments from Confluence into a structured ClickUp hierarchy.

The import tool is designed to save time, keep your documentation organized, and make your team transition smoother with minimal manual work.

How the ClickUp Confluence import works

The Confluence importer connects directly to your Confluence cloud site. It scans your spaces and pages, then lets you choose what to bring into ClickUp as Docs, tasks, and related items.

During the import, ClickUp converts your content into equivalent structures so you can keep working without recreating documents from scratch.

What you can import from Confluence to ClickUp

Using the Confluence importer, you can bring in:

Spaces, including their page trees
Pages and subpages
Content such as headings, text, lists, and tables
Attachments referenced in supported pages
Basic formatting for readable documentation

This allows your team to keep the knowledge base structure familiar when switching to ClickUp.

What the ClickUp importer does not support

Some items from Confluence are not imported. These include:

Marketplace apps and macros that cannot be rendered outside Confluence
Certain embedded integrations or custom scripts
Permission schemes that cannot be mapped directly

After the import, you may need to recreate advanced automations or app-based features within ClickUp using ClickUp-native tools.

Requirements before importing into ClickUp

Before running the import, confirm that your Confluence and ClickUp accounts meet the necessary requirements so the import can complete successfully.

Confluence account requirements

Make sure you have:

Access to Confluence Cloud (the importer is designed for the cloud version)
Permission to view the spaces and pages you want to import
Administrative or sufficient access rights if global settings are involved

If you cannot see a space in the importer, check your permissions in Confluence first.

ClickUp workspace requirements

In your ClickUp Workspace, confirm:

You are a member with permission to add and manage content
You know which Space and Folder structure will receive the imported docs
Your plan and workspace limits allow for the additional docs and storage

Planning the target structure in ClickUp ahead of time makes it easier to organize your imported data.

Start a Confluence import into ClickUp

Once you are ready, you can launch the importer and link Confluence to ClickUp.

Step 1: Open the ClickUp import menu

Sign in to your ClickUp Workspace.
Open your avatar or workspace menu, depending on your layout.
Look for an option such as Import or Import data in the settings or sidebar.
Select the Confluence option from the available import tools.

This opens the dedicated Confluence import screen in ClickUp.

Step 2: Connect ClickUp to Confluence

On the Confluence import screen, select Connect or Authorize.
You will be redirected to Confluence to sign in if you are not already.
Review the requested access permissions for the importer.
Approve access so ClickUp can read the spaces and pages required for import.

After authorization, you are returned to ClickUp, where the importer begins scanning your Confluence content.

Step 3: Choose spaces and pages to import

Wait while ClickUp lists available Confluence spaces.
Select one or more spaces that hold the pages you want.
Expand a space to see individual pages if the importer offers page-level selection.
Check or uncheck items to refine which data should move into ClickUp.

This selection step helps you avoid importing outdated or irrelevant documentation.

Map Confluence content to ClickUp

After choosing spaces and pages, you will decide how they appear inside your ClickUp hierarchy.

Step 4: Select target location in ClickUp

Choose the ClickUp Space where imported docs will live.
Optionally choose an existing Folder or create a new Folder for imported content.
Confirm how individual pages should appear, such as Docs inside a particular List or area.
Review any additional mapping options offered by the importer.

Keeping imported docs together in a dedicated Folder or Space can make it easier to review and reorganize later.

Step 5: Configure import options in ClickUp

Depending on the importer version, possible options may include:

Importing attachments with pages
Including archived pages or excluding them
Preserving page hierarchy as a tree of Docs
Handling page titles that duplicate existing Doc names

Set each option based on how you expect to manage documentation inside ClickUp after the migration.

Step 6: Run the import from Confluence

Review the summary of what will be imported into ClickUp.
Confirm that the selected spaces and pages match your expectations.
Click the button to start the import process.
Keep the ClickUp window open until the importer indicates that the process has started successfully.

Larger Confluence spaces may take longer, but the importer runs in the background so you can continue working in ClickUp.

Review your imported Confluence data in ClickUp

When the import completes, you should verify that everything appears correctly in your Workspace.

Step 7: Verify structure and content

Open the ClickUp Space and Folder you chose as the target.
Browse the imported Docs or items to confirm the hierarchy is accurate.
Scan a selection of pages to check text, headings, and lists.
Confirm that attachments and links inside Docs open correctly.

Use this review to spot any pages that might need formatting adjustments or additional cleanup.

Step 8: Organize imported Docs in ClickUp

Once the content is in ClickUp, you can:

Move Docs between Spaces and Folders
Update naming conventions to match your new documentation standards
Add tags, relationships, or tasks that reference the Docs
Set sharing or permissions appropriate for your team

Taking time to refine organization helps your team find information quickly in ClickUp.

Troubleshooting Confluence imports in ClickUp

If something does not look right after running the importer, there are a few common areas to check.

Missing spaces or pages

If spaces or pages do not appear in the ClickUp importer list:

Confirm you have permission to view them in Confluence.
Log out and back into Confluence, then refresh the ClickUp importer.
Check whether the content is part of Confluence Cloud and not a separate instance.

Formatting issues in imported Docs

Complex formatting from Confluence may not always map perfectly into ClickUp. When you see formatting differences:

Review the original page in Confluence to see which elements are involved.
Simplify or adjust heavily customized layouts inside ClickUp Docs.
Replace unsupported macros with native ClickUp features where possible.

Import performance or errors

For issues with import time or unexpected errors:

Try importing a smaller subset of pages first.
Check your network connection while starting the import.
Consult the official help article at Import from Confluence for current limitations and notes.

Next steps after importing into ClickUp

After you migrate from Confluence, explore additional features to enhance your new documentation workflow.

Create task links from Docs to coordinate work items.
Use collaboration tools such as comments and assigned comments.
Set up templates for recurring documentation patterns.
Leverage search to quickly find imported content in ClickUp.

If you need broader workspace optimization or migration strategy, you can also learn best practices from external resources such as Consultevo, which focuses on modern productivity platforms and process design.

By correctly using the Confluence importer and organizing your Docs afterward, your team can smoothly adopt ClickUp while preserving the knowledge base you built in Confluence.

Need Help With ClickUp?

If you want expert help building, automating, or scaling your ClickUp workspace, work with ConsultEvo — trusted ClickUp Solution Partners.

Get Help

“`