You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
3. On the **Select Project** step, choose the Plane project where you want to import your work items. The project must already exist — create it first if needed.
description: Import work items from CSV files to Plane.
3
+
description: Import work items from CSV files to Plane using the Flatfile importer.
4
4
---
5
5
6
6
# Import your CSV data to Plane
7
7
8
-
With the Flatfile importer, you can easily import work items from your CSV file to Plane.
8
+
The Flatfile importer provides a streamlined way to bring your work items into Plane from CSV files. With intelligent field mapping and data validation, you can migrate your data accurately and efficiently.
9
9
10
10
::: info
11
-
The Flatfile importer is only available on Plane Cloud. A separate [CSV importer](/importers/csv)is available on both Cloud and the self-hosted Commercial Edition.
11
+
The Flatfile importer is only available on Plane Cloud. If you're using the self-hosted Commercial Edition, use the [CSV importer](/importers/csv)instead.
12
12
:::
13
13
14
14
## Import from CSV
15
15
16
16
> **Role**: Workspace admins
17
17
18
-
::: warning Work Item Types
19
-
To import work item types, make sure the [Work item types](/core-concepts/issues/issue-types) feature is enabled in your Plane project.
20
-
:::
21
-
22
18
Here's how to get started:
23
19
24
20
1. Click your Workspace name at the top left on the sidebar.
25
21
26
22
2. Select **Settings**.
27
23
28
-
3. In the right pane, click on **Imports**.
24
+
3. In the right pane, click **Imports**.
25
+
26
+
4. Look for the **Flatfile Importer** tile (marked Beta) and click the **Import** button.
27
+
28
+
29
+
30
+
5.**Configure your destination project**
31
+
32
+
Select the Plane project where you want your CSV data to go. If you haven't created your destination project yet, you'll need to create it first before proceeding.
4. You'll see several import options - look for the **Flatfile Importer**tile and click the **Import** button.
40
+
Click **Upload CSV**to begin the upload process.
31
41
32
-
5. Use the dropdown to select the project where you want your CSV data to go. If you haven't created your destination project yet, you'll need to create it first.
You can either drag and drop your file onto the upload area, click to browse your files, or manually enter data if you prefer to input information directly.
35
45
36
-
::: warning Prepare your CSV
37
-
When importing user fields like **Assignee**, make sure to use email addresses rather than usernames. This ensures your team members are correctly linked to their work items.
46
+
::: tip Sample CSV template
47
+
Download our [sample CSV file](https://media.docs.plane.so/importers/flatfile/flatfile-import-sample.csv) to see the correct format and field structure for importing your data.
48
+
49
+
Make sure your CSV is properly formatted before uploading. Save your CSV file with UTF-8 encoding. Malformed rows or mismatched columns may cause individual rows to fail during import.
38
50
:::
39
51
40
-
7. You can either drag and drop your file onto the upload area or click **Upload file** to browse your files. Alternatively, you can click **Manually enter data** if you prefer to input information directly.
52
+
7.**Map your fields**
53
+
54
+
The field mapping screen appears with two columns:
55
+
-**INCOMING FIELDS** (left): Your CSV column headers
The importer automatically maps fields when column names match Plane's field names. You can adjust any mapping by clicking the dropdown next to each incoming field.
61
+
62
+
Required fields are marked with an asterisk (*).
63
+
64
+
::: warning User fields require email addresses
65
+
For fields like **Assignees** and **Created By**, you must use email addresses rather than usernames. This ensures team members are correctly linked to their work items in Plane.
66
+
:::
67
+
68
+
8.**Validate field values**
69
+
70
+
For fields like State and Priority, you'll need to map your CSV values to valid Plane options:
71
+
- The screen shows each unique value from your CSV under "Incoming Values"
72
+
- Select the matching Plane value from the "Destination Values" dropdown
73
+
- The mapping count shows your progress (e.g., "0 of 2 values mapped")
41
74
42
-
8. You'll need to match your CSV columns to Plane fields:
43
-
- You'll see your CSV fields listed under **INCOMING FIELDS** on the left.
44
-
- On the right, under **DESTINATION FIELDS**, select the corresponding Plane field for each item. Fields will be automatically mapped when names match, but you can adjust as needed.
45
-
- Required fields are marked with an asterisk (\*).
75
+
46
76
47
-
9. Once you've mapped your fields, click **Continue**to proceed.
77
+
Continue mapping until all values are matched to valid Plane options.
48
78
49
-
10. You'll see a preview of your data in a table view:
50
-
- Review the data to make sure everything looks correct.
51
-
- If something's not right, you can click Back to adjust your field mapping.
52
-
- When you're ready, click **Submit** to import your data.
79
+
Click **Continue** when all fields are properly mapped.
53
80
54
-
11. That's it! Your CSV data is now imported into your Plane project. For very large datasets, the import might take a few minutes to process.
81
+
9.**Review your data**
82
+
83
+
You'll see a table preview of your data with all mapped fields. This is your last chance to verify everything looks correct before import.
Copy file name to clipboardExpand all lines: docs/workspaces-and-users/billing-and-plans.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -150,7 +150,7 @@ When you create a new Plane workspace on our Cloud, you automatically start a 14
150
150
151
151
The trial includes all Business plan features, full seat capacity for your team, and AI credits for Plane AI features. No payment method is required.
152
152
153
-
After 14 days, your workspace automatically reverts to the Free plan if you haven't upgraded to a paid subscription.
153
+
After 14 days, your workspace automatically reverts to the Free plan if you haven't upgraded to a paid subscription, and you won’t be charged if a payment method was never added.
0 commit comments