Skip to content

Commit ab30915

Browse files
Merge pull request #376 from makeplane/export-filters
Workspace export filters
2 parents dd62124 + 2d73f30 commit ab30915

File tree

5 files changed

+60
-21
lines changed

5 files changed

+60
-21
lines changed

docs/core-concepts/cycles.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,3 +213,12 @@ You can archive completed cycles, allowing you to conceal significantly older cy
213213
## Delete cycles
214214

215215
You can delete a Cycle to remove it entirely. When you do, all associated analytics and progress reports will be erased. Any work items linked to that Cycle will also be automatically unlinked.
216+
217+
<div className="tag-wrapper">
218+
## Export cycles
219+
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
220+
</div>
221+
222+
You can export cycle data to analyze sprint performance, create reports, or share progress with stakeholders outside of Plane. Exports include all work items within the cycle along with their key details.
223+
224+
Learn more about [custom exports](/core-concepts/export#custom-exports).

docs/core-concepts/export.mdx

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -8,48 +8,47 @@ import Tags from "@site/src/components/Tags";
88

99
# Export data
1010

11-
Plane allows you to export all your work items—from a single project or multiple projects—so you can access your data outside of Plane. You can export work items into CSV, Excel, or JSON formats. Additionally, you can choose how you'd like the data to be packaged: in a single consolidated file or split into separate files (downloaded as a ZIP).
12-
13-
:::caution[Limitation]
14-
All key fields related to your work items are included in the export, except for work item types, custom properties, relations, links, attachments, and estimates. We're actively working on adding these soon.
15-
:::
11+
Plane allows you to export all your work items, from a single project or multiple projects, so you can access your data outside of Plane. You can export work items into CSV, Excel, or JSON formats.
1612

1713
## Export projects
1814

1915
> **Role**: Workspace Admins
2016
21-
1. Go to your **Workspace Settings**.
22-
2. In the right pane, select **Exports**.
23-
3. **Choose format**
24-
You can export work items in one of the following formats: - CSV: A plain text file with values separated by commas. - Excel: A formatted spreadsheet file. - JSON: A lightweight, machine-readable format.
25-
26-
Click the **Export** button for your preferred format.
17+
1. Go to your [Workspace Settings](/core-concepts/workspaces/overview#access-workspace-settings).
18+
2. In the left pane, select **Exports**.
2719

28-
![Export work items](https://media.docs.plane.so/workspaces/export-issues.webp#hero)
20+
![Export data](https://media.docs.plane.so/workspaces/export-data.webp#hero)
2921

30-
4. **Select Project**
31-
After selecting your format:
22+
3. **Select Project**
3223
- Choose to export work items from all projects or a specific project using the dropdown.
33-
- _Optional_: If exporting work items from all projects, you can split the data into separate files. This will package the exports into a ZIP file.
3424

35-
![Select project](https://media.docs.plane.so/workspaces/select-projects.webp#hero)
25+
4. **Choose format**
26+
You can export work items in one of the following formats:
27+
- CSV: A plain text file with values separated by commas.
28+
- Excel: A formatted spreadsheet file.
29+
- JSON: A lightweight, machine-readable format.
30+
31+
5. **Apply filters**
32+
Narrow down your export by filtering work items based on available filters.
33+
34+
6. **Click Export**
35+
This will package the export into a ZIP file.
3636

3737
:::info
3838
Exporting large workspaces may take some time depending on the number of work items.
3939
:::
4040

41-
5. **Download file**
41+
7. **Download file**
4242
You can view the history of your exports under **Previous exports**. For each export:
4343

4444
- You'll see its status (e.g., Queued, Completed).
4545
- The date and the name of the user who triggered the export.
46-
- Once completed, you can download the file by clicking **Download**.
47-
- Click the **Refresh status** button to ensure the latest updates.
46+
- The format used for the export.
4847

49-
![Download file](https://media.docs.plane.so/workspaces/download-file.webp#hero)
48+
Once completed, click **Download** to get your file. Use the **Refresh status** button to check for the latest updates.
5049

5150
:::caution
52-
Exported files remain downloadable for a limited time (7 days).
51+
Exported files remain downloadable for a limited time (7 days). After this period, they will show as "Expired" and you'll need to create a new export.
5352
:::
5453

5554
<div className="tag-wrapper">

docs/core-concepts/issues/overview.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -201,3 +201,14 @@ Within your project, you can set up automations to perform the following tasks:
201201
You can also automate the closing of work items that are still open after a certain period of time. This is useful for ensuring that work items don’t remain open unnecessarily, helping to keep your project board organized and up to date. The automation will move all open work items matching the time period to a selected closed state.
202202

203203
![Project close automation](https://media.docs.plane.so/projects/auto-close-issues.webp#hero)
204+
205+
<div className="tag-wrapper">
206+
## Export work items
207+
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
208+
</div>
209+
210+
You can export your work items to access and analyze your data outside of Plane. Exports support CSV and JSON formats, and you can filter exactly which work items to include.
211+
212+
This is useful when you need to create reports, perform external analysis, or share data with stakeholders who don't use Plane.
213+
214+
Learn more about [custom exports](/core-concepts/export#custom-exports).

docs/core-concepts/modules.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ title: Organize project features with Modules
33
sidebar_label: Modules
44
description: Use Modules to organize work items, track feature development, and break down projects into manageable components with progress tracking and multiple layouts.
55
---
6+
import Tags from "@site/src/components/Tags";
7+
68

79
# Break your project down into Modules
810

@@ -102,3 +104,12 @@ Archive completed Modules to declutter your views while preserving historical da
102104
## Delete Module
103105

104106
If a Module is no longer needed, you can delete it. Deleting a Module removes its progress analytics and de-links all associated work items.
107+
108+
<div className="tag-wrapper">
109+
## Export modules
110+
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
111+
</div>
112+
113+
You can export module data to track progress, create reports, or share module updates with stakeholders outside of Plane. Exports include all work items within the module along with their key details.
114+
115+
Learn more about [custom exports](/core-concepts/export#custom-exports).

docs/core-concepts/views.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,12 @@ You can remove views by deleting them from the list of views in your workspace o
7878

7979
- Mark frequently used views as favorites for quick access. Favorited views appear on the sidebar under **Your Favorites** section.
8080
- Use the search bar in the **Views** section to locate specific views quickly.
81+
82+
<div className="tag-wrapper">
83+
## Export views
84+
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
85+
</div>
86+
87+
You can export data from any saved view to analyze filtered work items, create custom reports, or share specific subsets of your project data. Exports respect all filters applied to the view.
88+
89+
Learn more about [custom exports](/core-concepts/export#custom-exports).

0 commit comments

Comments
 (0)