✦Currently in private beta.
Settings & Admin

Import Data

Intermediate8 min read

Migrate your projects from Trello, Asana, ClickUp, Notion, Monday.com, Linear, or Jira into QONE in minutes.

Key concepts

  • Source Platform: The tool you are migrating from. QONE supports seven platforms out of the box.
  • Export File: A .json or .csv file you download from the source platform. Each platform has its own export format. Maximum file size is 10 MB.
  • Import Wizard: A 3-step in-app flow -- Source -> Upload -> Review. Member mapping, import options, and the parsed preview all live in the final Review step.
  • Preview: After uploading, QONE parses the file and shows you what will be imported -- tasks, comments, columns, and members -- before anything is created.
  • Member Mapping: Match users from the source platform to existing QONE users so task assignments carry over correctly. Members are auto-matched by email first, so you only need to map the ones QONE could not match.
  • Background Job: The actual import runs as a background process. You can monitor progress in real time and cancel if needed. Only one import can run per workspace at a time -- a new import is blocked while another is Pending, Parsing, or In Progress.
How to

Step-by-step

Before You Start: Export from Your Source Platform

  1. Open the board you want to export.

  2. Click the ... menu (top-right of the board).

  3. Select More > Print and Export.

  4. Click Export as JSON.

  5. Save the `.json` file to your computer.

    Asana

  6. Open the project you want to export.

  7. Click the dropdown arrow next to the project name.

  8. Select Export / Print > CSV.

  9. Save the `.csv` file to your computer.

    Jira

  10. Go to your Jira project.

  11. Open the Issue Navigator (Filters > Advanced search).

  12. Filter issues by project: `project = "YOUR_PROJECT"`.

  13. Click Export in the top-right corner.

  14. Select Export CSV (all fields).

  15. Save the `.csv` file to your computer.

    ClickUp

  16. Open the space or list you want to export.

  17. Click the ... menu at the top.

  18. Select Settings > Export.

  19. Choose CSV format.

  20. Save the `.csv` file to your computer.

    Linear

  21. Go to Settings > General > Export.

  22. Select the projects you want to export.

  23. Click Export as CSV.

  24. Save the `.csv` file to your computer.

    Monday.com

  25. Open the board you want to export.

  26. Click the ... menu at the top-right of the board.

  27. Select More actions > Export board to CSV.

  28. Save the `.csv` file to your computer.

    Notion

  29. Open the database you want to export.

  30. Click the ... menu at the top-right.

  31. Select Export > Markdown & CSV.

  32. Choose CSV format.

  33. Unzip the downloaded file and locate the `.csv`.

Steps 1 & 2: Select Source and Upload Your File

  1. Go to Settings > Import.

  2. Step 1 (Source): On the import dashboard, you will see a grid of supported platforms. Click the card for your source platform (e.g., Trello).

  3. Step 2 (Upload): A file upload area appears for the platform you picked.

  4. Click Choose File or drag and drop your export file.

  5. QONE accepts `.json` files (for Trello) and `.csv` files (for all other platforms). Maximum file size is 10 MB.

  6. Click Upload and Parse.

    Note: Only users with the Import Projects permission can access this page.

Step 3: Review, Map, and Set Options

  1. Review the parsed data summary: number of tasks, comments, members, and columns found.

  2. In the Member Mapping section, each external user from the source file is listed. QONE has already auto-matched members by email, so confirm the matches and only adjust the ones it could not match.

  3. For each unmatched member, select the matching QONE user from the dropdown, or leave unmapped if the person is not in your workspace.

  4. Review the column/status preview -- QONE maps source statuses to task columns automatically.

  5. Set the import options:

    • Import into -- target an existing project, or create a new project (the default).
    • Skip archived tasks -- on by default; turn it off to import archived items too.
    • Conflict handling -- choose Import all (the default) or Skip duplicates.

  6. When you are satisfied, click Start Import.

    Tip: Unmapped members will not be assigned to tasks. You can reassign tasks after the import completes.

Tracking Import Progress

  1. After clicking Start Import, QONE redirects you to the import progress page.

  2. A progress indicator shows the current status:

    • Pending -- queued for processing.
    • Parsing -- reading and validating the file.
    • In Progress -- creating projects, columns, and tasks.
    • Completed -- all done.
    • Failed -- something went wrong (see error details).

  3. You can Cancel an in-progress import if needed.

    Note: Only one import can run per workspace at a time. While an import is Pending, Parsing, or In Progress, starting a new one is blocked until it finishes or is cancelled.

Review the Result

  1. Once the import shows Completed, navigate to Projects in the sidebar.

  2. Your imported project appears in the project list.

  3. Open it to verify:

    • Task columns match your expected workflow.
    • Tasks are assigned to the correct team members.
    • Labels/tags carried over.

  4. Make any adjustments as needed (rename columns, reassign tasks, add missing details).

Troubleshooting

| Problem | Solution | | ----------------------------------------- | --------------------------------------------------------------------------------------------- | | "File too large" error | Ensure your file is under 10 MB. Split large exports into smaller files. | | "Only .json and .csv files are supported" | Check the file extension. Trello uses .json; all others use .csv. | | "Source is not supported yet" | Verify you selected the correct platform card before uploading. | | "Failed to parse file" | The file format may not match expectations. Re-export from the source platform and try again. | | Tasks missing after import | Check member mapping -- unmapped members' tasks may exist but lack assignees. |

Tips & best practices

  • Clean up your source data before exporting. Remove test tasks, archived items, and inactive members to keep the import lean.
  • Map all active members to QONE users before starting the import. It saves time compared to reassigning tasks afterward.
  • Start with one project to test the import flow before migrating everything.
  • Check column ordering after import -- QONE preserves the order from the source file, but you may want to adjust it.
  • File size limit is 10 MB. For very large exports, consider splitting by project or removing attachments from the export (attachments are not imported -- only task data).
  • Cancel early if you see errors. It is better to fix the source file and re-import than to clean up partial data.

Was this article helpful?

Your feedback helps us improve these guides.