# Import from Todoist

Bring your active Todoist projects, tasks, sub-tasks, labels and due dates into Super Productivity in one pass. The import is **additive**: it only creates new projects, tags and tasks and never changes or removes existing Super Productivity data.

## What you need

- A Todoist account and its **API token**: in Todoist, open **Settings → Integrations → Developer** and copy the token. The token is sent only to `api.todoist.com` and is never stored.

## Steps

1. Open **Settings** (gear icon in the sidebar).
2. Open the **Sync & Backup** tab and find the **Import/Export** section.
3. Click **Import from Todoist**.
4. Paste your API token and click **Load preview**.
5. Review the preview: pick the projects to import (projects whose name already exists — for example from a previous run — are flagged and unchecked by default) and optionally choose how to carry over Todoist priorities (see [Priorities](#priorities) below).
6. Click **Import**. The summary lists what was created and everything that could not be carried over.

## What is imported

- Active projects (nested project hierarchy is flattened; the Todoist Inbox becomes a project named “Inbox (Todoist)”)
- Active tasks and sub-tasks (Super Productivity nests two levels; deeper sub-tasks become direct sub-tasks of their top-level task)
- Task descriptions and comments (into task notes; HTTP(S) comment file attachments keep their link)
- Labels used by imported tasks (as tags, on top-level tasks)
- Due dates, including times, and minute-based durations (as time estimates)
- Recurring tasks keep their next due date; the recurrence rule is added to the task notes (e.g. `Repeats: every 3 days`)

## Priorities

Todoist priorities are **off by default**. In the preview you can pick one of:

- **p1–p3 tags** — adds a `p1`, `p2` or `p3` tag to each top-level task (Todoist's default p4 stays untagged).
- **Eisenhower matrix** — reuses Super Productivity's built-in `urgent` / `important` tags, so imported tasks appear in the Eisenhower Matrix board: p1 → urgent + important, p2 → important, p3 → urgent, p4 → neither. Because a single Todoist priority is being split across the two axes, this mapping is a sensible default rather than an exact translation.

Priority tags are only added to top-level tasks — sub-tasks in Super Productivity can't hold tags.
The preview counts prioritized sub-tasks that will not receive the selected priority tags.

## What is not imported

- Completed tasks and task history
- Nested project hierarchy and sections (project and task order is preserved)
- Labels and mapped priorities on sub-tasks
- Reminders, full-day durations, collaborator assignees and attachment files
- Recurrence rules as real repeating tasks — recreate important ones via [[2.06-Manage-Repeating-Tasks]]

Unusually long project names, task titles, labels and task notes are shortened to
safe import limits. The preview reports how many selected values are affected.

If the import stops midway (e.g. connection loss), delete the project named in the
error because it may be incomplete. Then re-run the import and select that project
and any remaining projects. Projects already listed as imported are complete. To
undo an import, delete the created projects.

The duplicate-title warning can check active Super Productivity projects only. If a
previously imported project was archived, restore or delete it before re-running the
import so that it can be detected.
