Import from ClickUp
The ClickUp importer migrates tasks, statuses, priorities, assignees, tags, and due dates from a ClickUp list into a SetGet project. ClickUp's hierarchy (Workspace > Space > Folder > List) maps to SetGet's simpler structure (Workspace > Project).
What gets imported
| ClickUp field | SetGet field | Notes |
|---|---|---|
| Task name | Work item title | Direct mapping |
| Task description | Work item description | Rich text converted |
| Status | State | Mapped via status table |
| Priority | Priority | Mapped via priority table |
| Assignee(s) | Assignee(s) | Matched by email |
| Tags | Labels | Created if they do not exist |
| Due date | Due date | Direct mapping |
| Start date | Start date | Direct mapping |
| Subtasks | Sub-work-items | Imported as child items |
| Time estimate | Estimate | Converted to SetGet estimate format |
| Checklists | Description appendix | Appended to description as a checklist |
Prerequisites
- A ClickUp account with access to the workspace and list you want to import.
- A ClickUp API token (generate at ClickUp > Settings > Apps > API Token).
- Admin or Owner role in your SetGet workspace.
Setup steps
Step 1 -- Connect to ClickUp
- Go to Settings > Import.
- Select ClickUp.
- Enter your ClickUp API token.
- Click Connect.
- SetGet validates the token and shows a "Connected" status.
Step 2 -- Select the list
- Navigate the ClickUp hierarchy: select Workspace > Space > Folder (optional) > List.
- SetGet scans the list and displays: task count, status count, tag count.
Step 3 -- Choose the target project
- Create new project -- uses the list name.
- Import into existing project -- select an existing project.
Step 4 -- Map statuses to states
| ClickUp status (example) | Suggested SetGet state |
|---|---|
| Open | Backlog |
| To Do | Todo |
| In Progress | In Progress |
| Review | In Review |
| Complete | Done |
| Closed | Done |
ClickUp supports custom statuses per list. Map each one to a SetGet state.
Step 5 -- Map priorities
| ClickUp priority | SetGet priority |
|---|---|
| Urgent | Urgent |
| High | High |
| Normal | Medium |
| Low | Low |
| No priority | None |
Step 6 -- Configure options
| Option | Description | Default |
|---|---|---|
| Import subtasks | Import as child work items | On |
| Import closed tasks | Include tasks with closed statuses | On |
| Import tags as labels | Convert tags to labels | On |
| Import checklists | Append checklists to descriptions | On |
| Import time estimates | Bring over estimate values | On |
Step 7 -- Start import
Click Start Import and monitor the progress screen.
Post-import validation
| Check | How to verify |
|---|---|
| Total count | Compare work item count to ClickUp task count |
| State distribution | Review board view columns |
| Priority spread | Filter by priority in list view |
| Labels | Check Settings > Labels |
| Due dates | Sort by due date to verify dates carried over |
| Subtasks | Expand parent items |
ClickUp hierarchy mapping
ClickUp's deep hierarchy does not map 1:1 to SetGet:
| ClickUp level | SetGet equivalent | Recommendation |
|---|---|---|
| Workspace | Workspace | Direct mapping |
| Space | No direct equivalent | Use as project naming convention |
| Folder | No direct equivalent | Use modules or labels |
| List | Project | One list = one SetGet project |
| Task | Work item | Direct mapping |
| Subtask | Sub-work-item | Direct mapping |
TIP
If you have multiple lists that logically belong together, import them all into the same SetGet project and use labels to distinguish the original list.
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Connection fails | Invalid API token | Generate a new token in ClickUp |
| List not found | Token lacks workspace access | Use a token with full workspace access |
| Statuses not matching | Custom statuses in ClickUp | Map each status manually |
| Checklists not appearing | Option disabled | Enable "Import checklists" |
| Rich text formatting lost | Unsupported ClickUp markup | Edit descriptions after import |
WARNING
ClickUp API rate limits may slow down large imports. For lists with 5,000+ tasks, expect the import to take several minutes.
Custom fields
ClickUp supports custom fields on tasks. During import:
| Custom field type | Handling |
|---|---|
| Dropdown | Mapped to labels (each option becomes a label) |
| Text | Appended to description |
| Number | Appended to description |
| Date | Mapped to due date if applicable |
| Checkbox | Appended to description |
| Email / Phone / URL | Appended to description |
Custom fields that do not map to SetGet fields are listed in a formatted table appended to the work item description.
Multiple list import
If you need to import multiple ClickUp lists into SetGet:
- Import each list into a separate SetGet project, or
- Import all lists into the same project and use labels to identify the original list.
For option 2, enable "Import tags as labels" and add a manual label matching the list name after import.
TIP
Plan your project structure before importing. Decide whether each ClickUp list becomes a separate project or whether lists are merged into a single project with labels.
Time estimates
If your ClickUp tasks have time estimates, the importer converts them to SetGet estimate values. ClickUp uses time-based estimates (hours/minutes) while SetGet supports both time-based and point-based estimates. Configure the estimate format in Project Settings > Estimates before importing.