# Importing Tasks
Starting a Team Project from a blank board may not be the fastest path. The Imports page brings in an existing spreadsheet or ClickUp workspace, while document imports turn individual files into trackable tasks and subtasks.
> [!quote] Bring it with you
> Whatever you already have, from a project spreadsheet to a single calendar invite, Imports helps turn it into work your team can track.
## Getting started
Open a Team Project and go to **Imports** from the project header or Settings. Choose **Spreadsheet**, **Document or file**, or **ClickUp**.
![[team-imports-source-picker.png]]
> [!note] Project owners only
> Bulk spreadsheet and ClickUp imports are limited to the project owner because they can create many tasks at once. Document imports follow the project's task-creation permission.
## Turning a document into a task
Choose **Document or file** from Imports, or select **Import files** inside an open team task when the file belongs as a subtask. Zaphiri interprets each file and prepares one task for each file.
![[team-document-import-wizard.png|699]]
- **Markdown and plain text**: A heading or meaningful first line becomes the title, with structured content in the description
- **Contact cards**: A VCF file becomes a task with the contact's name and available contact details
- **Calendar files**: An ICS event becomes a task with event details and an optional suggested due date
- **Other files**: An unrecognised format still becomes a task using its filename, with the original file attached
Review the editable title, description, and any suggested due date before confirming. Nothing is created until you approve the preview.
Dropping several files creates a separate preview and task for each one. At the project level they become top-level tasks; inside an open task they become its subtasks.
> [!tip] The source stays with the task
>
> The original document is attached to the created task so the interpreted description and source file remain together.
## Importing from a spreadsheet
1. **Upload** a CSV or XLSX file
2. **Map columns**: match each spreadsheet column to a Zaphiri field (title, description, status, assignee, due date, priority, labels). Zaphiri auto-matches columns with obvious names
3. **Review** a preview of what will be created before committing
4. **Import**: the file is processed as a background job, so you can navigate away and check back
A row with a status, priority, or assignee that doesn't match anything in the project still imports. It falls back to a sensible default and is flagged with a warning instead of blocking the whole run.
## Importing from ClickUp
1. **Connect** with a ClickUp personal API token. Zaphiri doesn't use ClickUp OAuth, so this is a token paste, not an account-linking screen. The token is stored per project, not per Zaphiri account
2. **Map Spaces and Lists** to destination Team Projects, with a "select all" shortcut and a toggle to prefix each imported task with its source folder or list name
3. **Import**: tasks come in with their title, description, status, priority, assignee, and due date mapped as closely as ClickUp's model allows
> [!tip] Re-importing is safe
> Importing the same ClickUp list again skips tasks already brought in, so you won't end up with duplicates.
## Import history
Every spreadsheet, ClickUp, or document import is logged with its source, status (Completed, Failed, or In Progress), when it started, and how many items were imported. Open a run's details to see the outcome item by item, or jump straight to the tasks it created.
## Undoing an import
Made a mistake, or imported the wrong list? Undo an import run to remove the tasks it created. Zaphiri asks for confirmation first, then marks the run as **Rolled back** once the tasks are gone.
> [!warning] Undo removes the created tasks
> Undoing an import deletes the tasks that run created. Any changes made to those tasks since the import go with them, including comments, status updates and subtasks added by hand.
---
**Next:** Once your tasks are in, manage them like any other team task. See [[Managing Team Tasks]].