→
ClickUp → Asana
Migrate your ClickUp space to Asana: folders, projects, tasks, and so on, through an easily guided user interface.
What gets migrated
- Folders (as projects or portfolios)
- Lists (as sections or projects)
- Tasks & subtasks (up to Asana's 5 levels)
- Statuses (to complete/incomplete + optional status field)
- Custom fields (date, people, enum, multi-enum, number, text)
- Assignees (matched by email; Asana allows one)
- Comments (stories)
- Attachments (re-uploaded ≤ 100 MB; links preserved)
- Tags (native)
- Time entries
- Dependencies
How the hierarchy maps
- Asana doesn't allow sub-projects; each ClickUp top-level folder can become a portfolio in Asana, and lists in those can become projects.
- Lists directly under a ClickUp space are turned into projects directly under the Asana space.
Prerequisites
- Adequate permissions in ClickUp; see the Before the migration section below.
- Adequate permissions in Asana; see the Before the migration section below.
During a running migration
- Live migration progress
- Pause & resume anytime
- Retry failed objects only
- CSV report + full API log
Security & data storage
DatMig's servers are hosted with a public cloud provider in France and are compliant with GDPR.
DatMig migrates your data on the fly and doesn't store any of your work data. Only object IDs and names are retained, for retry and reporting purposes.
Before the migration
Authentication
Before you can migrate any data, you'll need to authenticate to both the platforms so that DatMig can access those. You can either authenticate through an API access token, or through OAuth 2.0 if the platforms support it. DatMig recommends that you use an API access token to authenticate as it's the relatively simpler and widely supported method.
| Platform | Method | How to get the credential |
|---|---|---|
| ClickUp | API access token | Generate a personal API token in ClickUp under Settings → Apps → API Token. Click here for more information. |
| OAuth 2.0 | Create an OAuth app in ClickUp (Settings → Apps → Create new app) to get a Client ID and Secret, then register the callback URL DatMig shows you. Click here for more information. | |
| Asana | API access token | Create a Personal Access Token in Asana under Settings → Apps → Developer apps. Click here for more information. |
| OAuth 2.0 | Register an app in the Asana developer console to get a Client ID and Secret, then register the callback URL DatMig shows you. Click here for more information. |
Permissions
- Permissions in ClickUp: Your account must have read permissions on all data you plan to migrate. You don't need to be an Administrator, however DatMig recommends that you get full access to the space you wish to migrate. You can only migrate what your account has access to. If your account doesn't have access to the required data, DatMig recommends that you use a Service Account that has access to the entire space.
- Permissions in Asana: Your account must have read, write, create, edit, delete permissions in the target space. DatMig recommends that you get full access to the target space. If your account doesn't have read, write, create, edit, delete permissions, DatMig recommends that you use a Service Account that has full access to the entire space.
Preparation of source & target
- Do a cleanup of the ClickUp space you want to migrate. That way, unwanted items will not be migrated to Asana.
- Create the needed custom fields in the target Asana space. In the migration mapping step (see here), DatMig will let you choose Asana custom fields to map to the ClickUp custom fields. Only the custom fields that are created in the target Asana space will be available for selection.
- Activate the Timesheets & Budgets add-on in Asana if you want to migrate time entry author and notes fields from ClickUp.
After the migration
- Go through the migration report to see exactly what was migrated and what wasn't.
- Manually address any objects that failed due to target-platform constraints (for example, unsupported characters or field limits); these can't be fixed by a retry.
- If you no longer need them, delete the API access tokens or OAuth apps you created for this migration.