Skip to content

Added CSV importer and other updates#420

Merged
sriramveeraghanta merged 5 commits intomasterfrom
updates-26-03-26
Mar 27, 2026
Merged

Added CSV importer and other updates#420
sriramveeraghanta merged 5 commits intomasterfrom
updates-26-03-26

Conversation

@danciaclara
Copy link
Copy Markdown
Collaborator

@danciaclara danciaclara commented Mar 27, 2026

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

References

Summary by CodeRabbit

  • New Features

    • Flatfile importer added (interactive CSV field mapping).
  • Improvements

    • Navigation relabeled: “IdP Group Sync” and “Workflows and Approvals”.
    • Project shortcut updated from P to N then P.
  • Documentation

    • New Flatfile guide; expanded CSV importer guidance (required fields, formatting, processing).
    • Added Enterprise Grid badge, AI self-hosting caution, workspace wording edits, importer availability clarifications, and a portal-based license delink workflow.

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 27, 2026 4:12am

Request Review

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 27, 2026

Warning

Rate limit exceeded

@danciaclara has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 22 minutes and 22 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 22 minutes and 22 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3d7f1791-3a35-4526-86c4-bdbd30aea691

📥 Commits

Reviewing files that changed from the base of the PR and between a32cbf8 and 6460e15.

📒 Files selected for processing (1)
  • docs/workspaces-and-users/manage-licenses.md
📝 Walkthrough

Walkthrough

Added a Flatfile importer page, sidebar entry, and SVG icon; relabeled two sidebar items; reworked CSV importer docs and importer overview; removed some availability callouts; and made several small copy/formatting updates across documentation pages.

Changes

Cohort / File(s) Summary
Site config & theme
docs/.vitepress/config.ts, docs/.vitepress/theme/components/Card.vue
Sidebar labels updated ("Group Sync" → "IdP Group Sync", "Workflows" → "Workflows and Approvals"); added /importers/flatfile route; added flatfile SVG icon to customSvgIcons.
New importer doc
docs/importers/flatfile.md
Added Flatfile importer guide: availability, prerequisites, workspace-admin steps, CSV mapping rules, field constraints, preview/submit flow, and verification notes.
Importers overview & CSV
docs/importers/overview.md, docs/importers/csv.md
Reordered importer cards and added Flatfile card; adjusted availability wording; reworked CSV importer docs with "Prepare your CSV", simplified workflow, expected CSV schema, and duplicate-import behavior note.
Importer availability removals
docs/importers/confluence.md, docs/importers/notion.md
Removed availability admonitions that previously referenced Plane Cloud / Commercial Edition self-hosting; no other content changes.
Core docs copy/formatting
docs/ai/pi-chat.md, docs/core-concepts/issues/plane-query-language.md, docs/core-concepts/projects/overview.md, docs/core-concepts/workspaces/overview.md, docs/workflows-and-approvals/workflows.md
Added Plane AI self-hosting caution; added "Enterprise Grid" badge to PQL title; changed project shortcut guidance (now N then P); simplified workspace wording; minor heading/line-break formatting edits.
Workspaces & licensing
docs/workspaces-and-users/manage-licenses.md
Expanded "Delink license key" with a portal-based delink workflow, navigation steps, confirmation details, and a screenshot; minor heading text added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested reviewers

  • sriramveeraghanta

Poem

🐰 A Flatfile hops in with columns aligned,
Sidebar labels refreshed, icons well designed,
CSVs prepped and mapped, previews in sight,
Docs trimmed and polished, the guidance feels right,
I nibble a carrot and celebrate tonight. 🥕✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title partially describes the changeset but is overly broad and vague. While the PR does add a CSV/Flatfile importer, it includes numerous other updates to documentation, configuration, and content across multiple files that the title does not capture. Consider a more specific title that reflects the primary change or use a more comprehensive summary, e.g., 'Update documentation for importers, add Flatfile support, and improve navigation labels' if the focus is multi-faceted.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch updates-26-03-26

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (4)
docs/.vitepress/config.ts (1)

305-305: Align sidebar label with target page title for consistency.

Line 305 uses “IdP Group Sync”, while the destination page title is “Manage project access with IdP groups” (docs/authentication/group-sync.md, Line 2). Harmonizing phrasing will make navigation feel less fragmented.

Possible adjustment
-              { text: "IdP Group Sync", link: "/authentication/group-sync" },
+              { text: "Manage project access with IdP groups", link: "/authentication/group-sync" },
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/.vitepress/config.ts` at line 305, Update the sidebar label string "IdP
Group Sync" used in the config entry with link "/authentication/group-sync" so
it matches the target page title "Manage project access with IdP groups" (i.e.,
change the visible text to that exact title) to ensure consistency between the
sidebar and the destination page.
docs/core-concepts/workspaces/overview.md (1)

10-10: Consider aligning tone with the rest of the docs page.

Line 10’s closing phrase (“if that’s how you roll”) reads more casual than adjacent sections. A neutral phrasing would keep voice consistent.

Proposed wording
-The workspace is where your team gathers to work on projects, track progress, and get things done. You can create your own projects, invite others to join, and collaborate as a group, or just do your own thing if that’s how you roll.
+The workspace is where your team gathers to work on projects, track progress, and get things done. You can create projects, invite others to join, and collaborate as a team.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/core-concepts/workspaces/overview.md` at line 10, The closing phrase in
the sentence "The workspace is where your team gathers to work on projects,
track progress, and get things done. You can create your own projects, invite
others to join, and collaborate as a group, or just do your own thing if that’s
how you roll." is too casual compared to the surrounding documentation; replace
"or just do your own thing if that’s how you roll" with a more neutral
alternative such as "or work independently if preferred" (or similar) so the
tone matches the rest of the page; update the sentence in overview.md
accordingly.
docs/importers/csv.md (1)

20-35: Reduce duplicated schema rules to prevent docs drift.

The allowed values/format rules are defined in both “Prepare your CSV” and “Imported fields.” Consider keeping one canonical schema section and linking to it from the other section so future updates stay consistent.

Also applies to: 76-85

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/importers/csv.md` around lines 20 - 35, The docs duplicate the
allowed-values and format rules for columns (e.g., priority,
start_date/target_date, state_group and description_html) across the "Prepare
your CSV" and "Imported fields" sections; pick one canonical schema section
(either "Prepare your CSV" or "Imported fields"), move the allowed-values/format
rules (priority: urgent/high/medium/low/none; dates: YYYY-MM-DD; state_group:
backlog/unstarted/started/completed/cancelled; description_html notes) into that
single section, remove the duplicate rules from the other section, and replace
the removed content with a short cross-reference/link to the canonical section
so future edits update only one place.
docs/importers/flatfile.md (1)

2-3: Make the page title explicitly Flatfile-specific.

This page currently looks title-wise like the standard CSV importer page. A Flatfile-specific title/description would improve discoverability and reduce ambiguity in search/navigation.

Proposed doc wording tweak
-title: Import data from CSV file
-description: Import work items from CSV files to Plane.
+title: Import data with Flatfile CSV Importer
+description: Import work items from CSV files to Plane using the Flatfile importer.

Also applies to: 6-8

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/importers/flatfile.md` around lines 2 - 3, Update the page title and
description to explicitly reference Flatfile (e.g., change "Import data from CSV
file" to "Import data with Flatfile" and adjust the description to mention
Flatfile's CSV import flow), and apply the same Flatfile-specific wording
changes to the other title/description instances referenced around lines 6-8 so
the page and its metadata clearly indicate this is the Flatfile importer
documentation.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/importers/flatfile.md`:
- Line 30: The documentation currently references the product tile label as
"Flatfile Importers" (the phrase in docs/importers/flatfile.md), but the UI uses
the singular "Flatfile Importer"; update the sentence that reads 'look for the
**Flatfile Importers** tile' to use the exact UI label "Flatfile Importer" so
the doc matches the UI verbatim and avoid user confusion.
- Line 54: Update the specified wording instances in docs/importers/flatfile.md:
replace “For very large datasets” with “For large datasets” (occurs at line
containing "That's it! Your CSV data..."), change “here's exactly what you can
transfer over” to “here's what you can transfer” (occurrence around the
transfers list), and change “originally created” to “created” (occurrence in
descriptions of source metadata); apply the same edits at the other noted
occurrences (the lines corresponding to 60 and 70).

---

Nitpick comments:
In `@docs/.vitepress/config.ts`:
- Line 305: Update the sidebar label string "IdP Group Sync" used in the config
entry with link "/authentication/group-sync" so it matches the target page title
"Manage project access with IdP groups" (i.e., change the visible text to that
exact title) to ensure consistency between the sidebar and the destination page.

In `@docs/core-concepts/workspaces/overview.md`:
- Line 10: The closing phrase in the sentence "The workspace is where your team
gathers to work on projects, track progress, and get things done. You can create
your own projects, invite others to join, and collaborate as a group, or just do
your own thing if that’s how you roll." is too casual compared to the
surrounding documentation; replace "or just do your own thing if that’s how you
roll" with a more neutral alternative such as "or work independently if
preferred" (or similar) so the tone matches the rest of the page; update the
sentence in overview.md accordingly.

In `@docs/importers/csv.md`:
- Around line 20-35: The docs duplicate the allowed-values and format rules for
columns (e.g., priority, start_date/target_date, state_group and
description_html) across the "Prepare your CSV" and "Imported fields" sections;
pick one canonical schema section (either "Prepare your CSV" or "Imported
fields"), move the allowed-values/format rules (priority:
urgent/high/medium/low/none; dates: YYYY-MM-DD; state_group:
backlog/unstarted/started/completed/cancelled; description_html notes) into that
single section, remove the duplicate rules from the other section, and replace
the removed content with a short cross-reference/link to the canonical section
so future edits update only one place.

In `@docs/importers/flatfile.md`:
- Around line 2-3: Update the page title and description to explicitly reference
Flatfile (e.g., change "Import data from CSV file" to "Import data with
Flatfile" and adjust the description to mention Flatfile's CSV import flow), and
apply the same Flatfile-specific wording changes to the other title/description
instances referenced around lines 6-8 so the page and its metadata clearly
indicate this is the Flatfile importer documentation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 28f8a228-3927-4c8a-8970-c0961dd2e8c4

📥 Commits

Reviewing files that changed from the base of the PR and between 5ce1e24 and 7ddcc9c.

📒 Files selected for processing (12)
  • docs/.vitepress/config.ts
  • docs/.vitepress/theme/components/Card.vue
  • docs/ai/pi-chat.md
  • docs/core-concepts/issues/plane-query-language.md
  • docs/core-concepts/projects/overview.md
  • docs/core-concepts/workspaces/overview.md
  • docs/importers/confluence.md
  • docs/importers/csv.md
  • docs/importers/flatfile.md
  • docs/importers/notion.md
  • docs/importers/overview.md
  • docs/workflows-and-approvals/workflows.md
💤 Files with no reviewable changes (2)
  • docs/importers/confluence.md
  • docs/importers/notion.md

- If something's not right, you can click Back to adjust your field mapping.
- When you're ready, click **Submit** to import your data.

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.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Tighten wording for concision and tone consistency.

Minor copy edits recommended:

  • “For very large datasets” → “For large datasets”
  • “here's exactly what you can transfer over” → “here's what you can transfer”
  • “originally created” → “created”

Also applies to: 60-60, 70-70

🧰 Tools
🪛 LanguageTool

[style] ~54-~54: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ...w imported into your Plane project. For very large datasets, the import might take a few m...

(EN_WEAK_ADJECTIVE)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/importers/flatfile.md` at line 54, Update the specified wording
instances in docs/importers/flatfile.md: replace “For very large datasets” with
“For large datasets” (occurs at line containing "That's it! Your CSV data..."),
change “here's exactly what you can transfer over” to “here's what you can
transfer” (occurrence around the transfers list), and change “originally
created” to “created” (occurrence in descriptions of source metadata); apply the
same edits at the other noted occurrences (the lines corresponding to 60 and
70).

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/workspaces-and-users/manage-licenses.md`:
- Line 70: Replace the duplicated heading text "In Portal portal" with a single
clear title (e.g., "In Prime portal") in the markdown file; locate the heading
string "In Portal portal" and update it to the chosen title so the section
header is not duplicated or typo'd.
- Line 78: The markdown image URL in the line containing "![Delink license key
in Prime portal](https://media.docs.plane.so/activate-license/ .webp#hero-tl)"
is malformed due to a stray space before ".webp"; fix it by removing the space
so the path becomes
"https://media.docs.plane.so/activate-license/<filename>.webp#hero-tl" (or the
correct filename) ensuring the image filename and extension are contiguous;
update the markdown alt-texted image line accordingly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3fc6cdbc-7f4c-4b0b-bdbe-f78eaa3fd4a6

📥 Commits

Reviewing files that changed from the base of the PR and between 7ddcc9c and 67e4aad.

📒 Files selected for processing (1)
  • docs/workspaces-and-users/manage-licenses.md

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
docs/importers/flatfile.md (1)

54-54: ⚠️ Potential issue | 🟡 Minor

Tighten recurring wording in three spots for consistency.

The same copy nits previously flagged are still present:

  • Line 54: “For very large datasets” → “For large datasets”
  • Line 60: “here’s exactly what you can transfer over” → “here’s what you can transfer”
  • Line 70: “originally created” → “created”
✍️ Suggested edits
-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.
+11. That's it! Your CSV data is now imported into your Plane project. For large datasets, the import might take a few minutes to process.

-When bringing your data from CSV into Plane, here's exactly what you can transfer over:
+When bringing your data from CSV into Plane, here's what you can transfer:

-| Created by     | **Must be email addresses** - allows Plane to track who originally created the item                         |
+| Created by     | **Must be email addresses** - allows Plane to track who created the item                                    |

Also applies to: 60-60, 70-70

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/importers/flatfile.md` at line 54, Update the wording in
docs/importers/flatfile.md to apply the three consistency edits: change "For
very large datasets" to "For large datasets", change "here’s exactly what you
can transfer over" to "here’s what you can transfer", and change "originally
created" to "created"; locate and replace those exact phrases in the document
(they appear near the CSV import summary and the transfer/creation descriptions)
so the copy is consistent across the file.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/importers/flatfile.md`:
- Line 54: Update the wording in docs/importers/flatfile.md to apply the three
consistency edits: change "For very large datasets" to "For large datasets",
change "here’s exactly what you can transfer over" to "here’s what you can
transfer", and change "originally created" to "created"; locate and replace
those exact phrases in the document (they appear near the CSV import summary and
the transfer/creation descriptions) so the copy is consistent across the file.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 76bc7f49-0396-4525-9088-16f3c6149774

📥 Commits

Reviewing files that changed from the base of the PR and between 67e4aad and a32cbf8.

📒 Files selected for processing (1)
  • docs/importers/flatfile.md

@sriramveeraghanta sriramveeraghanta merged commit e7e1f0a into master Mar 27, 2026
5 checks passed
@sriramveeraghanta sriramveeraghanta deleted the updates-26-03-26 branch March 27, 2026 05:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants