> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knowlix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from Asana

> How to export your data from Asana and import it into Knowlix

This guide walks you through migrating your Asana data to Knowlix. Before you start, make sure you have **admin or member access** to the Asana workspace — you need at least edit access to the projects you want to export.

## What You Can Migrate

Asana organizes work into projects and tasks. Here is what transfers to Knowlix:

* **Projects** — top-level containers for work
* **Tasks** — individual work items within projects
* **Subtasks** — tasks nested under parent tasks
* **Assignees** — team members assigned to tasks
* **Due dates** — deadlines set on tasks and subtasks
* **Sections** — groupings within a project (columns in Board view)
* **Tags** — labels applied to tasks for categorization
* **Custom fields** — any additional fields configured on projects

<Note>
  **Comments and attachments are not included** in Asana's native CSV or JSON exports. If you need to preserve comments, you will need to use the Asana API or a third-party export tool before migrating.
</Note>

## Step 1: Export Your Data from Asana

Asana exports are done per project. You will need to repeat these steps for each project you want to migrate to Knowlix.

**To export a single project:**

1. Open the **project** you want to export in Asana
2. Click the **dropdown arrow (▾)** next to the project name in the top header
3. Select **Export/Print** from the dropdown menu
4. Choose your export format:
   * **CSV** — best for spreadsheet-compatible imports; subtasks appear as separate rows
   * **JSON** — preserves task hierarchy (subtasks nested under parent tasks); useful for API-based imports
   * **XLSX** — Excel format, similar to CSV layout
5. The file downloads automatically to your computer

### Choosing the Right Format

| Format | Subtasks            | Comments     | Best for                |
| ------ | ------------------- | ------------ | ----------------------- |
| CSV    | Separate rows       | Not included | Knowlix import          |
| JSON   | Nested under parent | Not included | API/custom imports      |
| XLSX   | Separate rows       | Not included | Reviewing data in Excel |

For uploading to Knowlix, **CSV is recommended**.

### Exporting Multiple Projects

Asana does not support bulk workspace-level exports from the UI. You need to export each project individually. If you have many projects, consider using the [Asana API](https://developers.asana.com/docs/export-project-statuses-to-csv) or a third-party tool to batch-export.

**Official Asana export documentation:** [Export Asana projects to CSV — Asana](https://asana.com/inside-asana/export-to-csv)

## Step 2: Upload to Knowlix

Once you have your CSV files from Asana:

1. Go to **Settings > Import** in Knowlix
2. Select **Asana** as the source platform
3. Upload the exported CSV file for each project
4. Knowlix will map tasks, assignees, and due dates automatically

## Step 3: Review & Confirm

Before the import is finalized, Knowlix shows you a field mapping preview. Here you can:

* Verify that Asana columns (e.g., "Task Name", "Assignee", "Due Date") are correctly matched to Knowlix fields
* Map Asana projects to the correct Knowlix workspace or project
* Choose how to handle subtasks (as nested tasks or as standalone items)
* Click **Confirm Import** to start the migration

## Need Help?

Contact us at [support@knowlix.ai](mailto:support@knowlix.ai) or ask your AI Teammate directly inside the app.