← See all migration guides

Migration guides

ClickUp data migration: plan a tailored transfer

A tailored ClickUp data migration starts by selecting active projects, their tasks, and useful documents. Define field mappings, test a small CSV export, and handle Docs separately. The ClickUp hierarchy is a reference, not a structure automatically recreated in Equilibrition.

Starting format

Workspace CSV plus separate Markdown Docs

CSV

CSV import available today

This guide uses CSV files, not an automatic native connector. Check export permissions and available fields before preparing the Equilibrition import.

Not decided yet? Read the ClickUp comparison first →

How do you scope a tailored ClickUp migration?

Adapt the transfer to your work: useful lists, status mappings, documents to keep, and archives to leave accessible. For founder-assisted migration, the scope is confirmed after reviewing exports and available formats. Recreating every ClickUp feature exactly is not guaranteed.

  • List the locations to export and check permissions for your ClickUp plan and role.
  • Prepare mappings for target project, status, due date, source ID, and parent link; document fields without an equivalent.
  • Test tasks with a subtask, date, and attachment; compare results with the source data.
  • Check unique IDs, links, and documents before switching; retain exports and source access.

Updated on

Path

The 3 migration steps

1

Export from ClickUp

In workspace settings, open Imports / Exports, choose Export Items, select the relevant Spaces, Folders, or Lists, then download the CSV.

  • Export access depends on your plan and role. Check selected locations and the columns in the resulting file.
  • Export each Doc separately as Markdown, HTML, or PDF; an export can include all pages within that Doc.
2

Import the CSV into Equilibrition

Prepare a CSV suited to the fields available in Equilibrition's import. Choose the object type and test field mappings on a sample. Do not assume automatic conversion of Spaces, Folders, or Lists into spaces and projects.

  • Transfer useful Doc text separately into notes and link them to the relevant projects.
  • Check attachment access and retain useful files separately; the CSV contains their names and URLs.
3

Review the mapping

Compare tasks by Task ID and check Parent ID before restoring useful links. Choose a main project for tasks in multiple lists. Keep other memberships as references if no target field fits.

  • Tracked time is a provenance metric, not planned duration.
  • Custom task types should be confirmed instead of forced into a single model.

Mapping

Mappings to validate before import

In the source toolIn EquilibritionReview point
Space and FolderOrganization referencesRecord the source hierarchy and choose your target organization; no space is assumed to be created automatically.
ListProject, where relevantA list may represent an engagement or just a category; decide before importing.
Task ID and Parent IDReference IDsUse them to deduplicate and check relationships; their presence does not automatically create parent-child links.
Statuses and datesAvailable task fieldsMap statuses; check Unix or text dates, the time zone, and values after import.
Exported DocNote or resourceTransfer content separately; embedded content is not included in the Doc export.
AttachmentsResources to checkA name and URL are not a file copy; check access and retention.

Watchouts

Limits to know before importing

  • Docs are exported separately; their embedded content needs separate checking and retention.
  • Multi-List tasks must be deduplicated by ID before validation.
  • Permissions, automations, and views are not recreated by mapping CSV columns.

Guide scope

This guide assumes neither an OAuth connection nor ongoing sync. Confirm formats, volume, and exceptions before any assisted migration.

Common questions about this migration

Do Docs and attachments automatically follow tasks?

No. Export Docs separately and transfer useful content after checking it. Attachment names and URLs in the CSV guarantee neither downloads nor lasting file access.

How do you avoid duplicates and incorrect dates?

Match rows by Task ID and check Parent ID for subtasks before validating links. The CSV includes Unix and text dates: choose a consistent format and check the time zone on your sample.

Founder Pass

Ready to bring your context into a clearer cockpit?

The Founder Pass gives access to the first CSV imports, priority feedback loops, and a lifetime locked-in price.

Claim the Founder Pass — €97

Free guide

Pick up any project without rebuilding its story.

The Context → Action guide: five steps to capture, keep the why, and fit what matters into your week. With the tools you already use.

You will also receive useful Equilibrition updates. Unsubscribe in one click.

  • Instant access, nothing to install
  • A method, not a product demo
  • It ends with a test to run this week

From step 03

website

review the hero and choose the final version

A task carrying its verb and its context can be picked up two days later without rereading your notes.

Your privacy choices

With your permission, NanoCorp/PostHog analyses browsing (including interaction replay), and Meta/OpenAI measure our advertising campaigns. These trackers are optional: refusing never blocks signup or purchase. Your choice applies to this site and device for 180 days, not to the app.

Privacy policy

By clicking OK, you accept all these trackers to help us improve the site and measure our campaigns. You can reject all or customize your choice, then change it at any time via Manage cookies.