> ## Documentation Index > Fetch the complete documentation index at: /help/llms.txt > Use this file to discover all available pages before exploring further. # Import tasks from Todoist or TickTick > Bring your Todoist projects or TickTick lists into Heym with their sections, labels, dates and priorities. Check a preview first, then import in one click. Heym can read Todoist's project exports and TickTick's backup file and turn them into Heym tasks, projects, sections and labels. You see a preview of everything first, and nothing changes in your account until you confirm. This page covers both apps, what comes across, and what to do if you're coming from an app Heym can't import. ## Open Import Click your name at the top of the sidebar, choose **Settings**, then **Import**. Under **Import from**, pick **Todoist** or **TickTick**. The steps for exporting from that app appear right below. ![The Import settings with Import from set to Todoist, the export steps for Todoist and a Choose files button](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/import/import-settings.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=1c4168fbf12b40698d63e9d7db54ebec) Settings → Import ## Import from Todoist Todoist exports one CSV file per project, and the file name becomes the project's name in Heym. **1. Export your projects from Todoist** In Todoist, open a project, click ⋯, then **Manage data** → **Export as CSV**, and save the file. Do this for every project you want to bring over, including your Todoist Inbox. **2. Choose the files in Heym** In **Settings** → **Import**, pick **Todoist** and click **Choose files**. You can pick up to 25 files at once. **3. Check the preview** Heym shows what it will create. See [Check the preview](#check-the-preview) below. **4. Import** Click **Import** (the button shows the number of tasks, such as **Import 8 tasks**). When it's done, Heym lists what it created. ## Import from TickTick TickTick puts all your lists into one backup file. **1. Make a backup in TickTick** In TickTick on the web or on your computer, open **Settings** → **Account** and click **Generate Backup** under **Backup & Restore**. TickTick downloads a CSV file. **2. Choose the file in Heym** In **Settings** → **Import**, pick **TickTick** and click **Choose file**. **3. Check the preview and import** Decide where each list goes and whether to bring completed tasks along, then click **Import**. ## Check the preview The preview's first lines sum up the import: how many tasks, how many new projects and sections, how many tasks go to the Inbox, and which new labels Heym will create. Below that, it says whether every row was read or lists what won't come across exactly. ![The import preview: 8 tasks from Todoist, 1 new project, 2 new sections, 2 tasks go to the Inbox, the new labels weekend and errands, and the note Every row was read. Nothing is left out.](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/import/import-preview.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=7c130b0536fe81710dfc34f06ca403db) The preview of two Todoist files ### Choose where each group goes Under **Where your tasks go**, every Todoist project or TickTick list is a group with its tasks. Each group becomes its own project in Heym, unless you send it to your Inbox: * Click **Project** next to a group's name and choose **Inbox** to put its tasks in your Heym Inbox instead. * **New project** means Heym will create the project. **Adds to existing project** means you already have a Heym project with that name, and the tasks go into it. * Your Todoist or TickTick inbox goes to your Heym Inbox. Tasks sent to the Inbox keep their dates. Undated ones show up in your Inbox. Dated ones show up in **Today** and **Upcoming** on their day, so the preview's "tasks go to the Inbox" count can be higher than what you see in the Inbox list. ![The group Garden with 6 tasks in two sections, Balcony and Allotment, and its menu open with the options Project and Inbox](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/import/import-destination.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=abdd2866a7876aacb717fa0ecf510b33) Send a group to the Inbox instead of a new project The task list shows each task as it will look in Heym, with its priority, labels and date. Text that ends up in a task's description, such as comments or Subtask of: lines, shows in small print under the task. ### Read the notes about changes If some tasks can't come across exactly as they are, the preview says so. Click a line such as **2 tasks import with changes** or **1 row skipped** to see which tasks and why: a date Heym couldn't read, a repeat it doesn't support, a dropped assignee. Tasks with changes still import, just without that part. One exception: a Todoist repeat Heym doesn't support imports without a date, so give the task its date and repeat again afterwards. Skipped rows don't import. ### Bring completed tasks along (TickTick) TickTick backups include completed tasks. They're left out unless you turn on **Include completed tasks** at the bottom of the preview. They then import already checked off. ![A TickTick preview noting that the lists in the folder Home come over as separate projects and that 1 completed task was left out, with the Include completed tasks switch turned off](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/import/ticktick-preview.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=2aefdcb4c2ad43b070e5b5c2b4a3d851) A TickTick preview Todoist's exports don't include completed tasks, so there's nothing to turn on. ## What comes across | In Todoist or TickTick | In Heym | | - | - | | Projects (Todoist), lists (TickTick) | Projects | | Sections (Todoist), kanban columns (TickTick) | Sections in the project | | Inbox | Inbox | | Labels (Todoist), tags (TickTick) | Labels. A label you already have with the same name is reused. | | Priorities | **High**, **Medium**, **Low** or no priority. Todoist's p1 becomes **High**, p4 no priority. | | Due dates and times, Todoist durations | Dates, start times and durations | | Repeating tasks | Repeating tasks, where Heym supports the repeat. Other Todoist repeats import without a date, and the preview lists them. | | Descriptions | Descriptions. Todoist comments are added to the description, TickTick checklist items become a checklist in it. | | Subtasks | Separate tasks in the same place, with "Subtask of:" and the parent's name at the top of the description | | TickTick reminders | Reminders, where Heym can set the same time | A Todoist task with a deadline but no date gets the deadline as its date. These don't come across: * **Todoist reminders and assignees.** Tasks import without them, and the preview lists each one. * **TickTick folders.** Heym has no folders, so each list in a folder becomes its own project. * **TickTick notes** and tasks marked **Won't do**. They're skipped. * **Dates written in another language.** Heym reads Todoist dates written in English. Others import without a date, and the preview says so. New projects aren't linked to a goal or a life area. Open each one afterwards and set its **Alignment**. See [Projects](/help/projects.md). ## What happens if… ### I import the same files twice Heym remembers what it imported and skips it. The preview says how many tasks were imported before and will be skipped. Only new tasks come across. Tasks you imported and then deleted still count while they're in Trash, so Heym skips them. To import them again, delete them for good from **Trash** first, or restore them instead. See [Undo and Trash](/help/undo-and-trash.md). Todoist exports have no task IDs, so Heym recognizes a Todoist task by its project, section, title, date and description. If you changed a task in Todoist since the last import, it counts as new and comes across again. ### I want to undo an import An import can't be undone in one step. To take it back: 1. Delete each new project it created: open the project, click **⋯** at the top right, choose **Delete** and confirm. Its tasks move to Trash. See [Projects](/help/projects.md). 2. Delete the other tasks it brought in yourself: the ones it added to a project you already had, and the ones it sent to your Inbox. Dated Inbox tasks are in **Today** and **Upcoming**. 3. Labels it created stay until you delete them. See [Labels](/help/labels.md). > [!WARNING] > > Don't delete a project you had before the import (**Adds to existing project** in the preview). Deleting it also moves your own tasks in it to Trash. ### Something went wrong If Heym can't read the files, it says so and shows no preview. Use each file exactly as Todoist or TickTick exported it, then try again. If you picked the wrong kind of file, the preview says **Nothing new to import.** and **1 row skipped**. Click **1 row skipped** to see why, for example **This isn't a Todoist export.** If the import itself fails, nothing is changed, so you can try again. ## Limits * **25 files** at once from Todoist. Import the rest in a second round. * **4 MB** per file and for all files together. * **5,000 tasks** per import. If there are more, import the same files again: Heym skips what's already there and brings in the next batch. * **5,000 characters** per description. Longer descriptions are cut off at the end. * **Projects on the Free plan:** you can have 3 projects. If an import would create more projects than you have room for, the preview says how many are free, and you can't click **Import** until the new projects fit. Send some groups to the Inbox, or [upgrade to Pro](/help/plans.md). ## Coming from Things 3 or Notion Heym can't import from Things 3 or Notion. Instead of copying everything, start with what you still use: the areas and projects you're working on now. Old and finished items can stay where they are. How a Things 3 setup maps onto Heym: | Things 3 | Heym | | - | - | | Areas | [Life areas](/help/life-areas.md) | | Projects | [Projects](/help/projects.md), linked to a life area | | Headings in a project | Sections | | To-dos | [Tasks](/help/tasks.md) | | Checklists in a to-do | A checklist in the task's description | | Tags | [Labels](/help/labels.md) | | Inbox | [Inbox](/help/inbox-today-upcoming.md) | | Today, Upcoming | Today, Upcoming | From Notion, move pages you still read into [Notes](/help/notes.md), and link each note to a goal or life area. Turn a task list into Heym tasks, ideally in a project or linked to a goal. What each block in Heym is for is on [How Heym fits together](/help/how-heym-works.md). ## Related > [card] [Projects](/help/projects.md) > > Sections, milestones and linking a project to a goal. > [card] [Labels](/help/labels.md) > > Rename and recolor the labels you brought along. > [card] [Inbox, Today and Upcoming](/help/inbox-today-upcoming.md) > > Sort the tasks that landed in your Inbox. > [card] [Free, Pro and Lifetime](/help/plans.md) > > Plan limits, including the 3 projects on Free. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.