How-To2026-10-292 min read

Import Issues from CSV into Linear

Use Linear CLI importer for generic CSV input, following its documented column format. Do not assume there is a universal browser upload wizard or a lossless import of comments and projects.

Step-by-step guide

01

Check access and scope

A workspace administrator needs the source CSV and access to run the supported importer. Prefer a dedicated migration assistant when your source tool has one.

02

Prepare the CSV template

Download a Linear CSV template and retain its headers.

03

Map destination values

Map titles, descriptions, statuses, assignees and labels deliberately.

  • Worked example: Test three invite-flow issues: an unassigned bug, an assigned task and a completed issue. Confirm that assignee full names match and estimates appear only after enabling team estimates.
04

Build an edge-case sample

Prepare a tiny sample containing multiline text and multiple labels.

05

Run the CLI importer

Open the CLI importer from Import/Export and follow its prompts. Follow the CLI tool prompts, choose the Linear CSV option and select the destination team; the source-tool assistant is preferable when available.

06

Inspect imported records

Inspect imported issues before importing the remaining records.

07

Verify the result

The sample preserves readable text, expected state and ownership without duplicate work.

Common mistakes

Avoid the main failure mode

Repeating an import is not a generic update operation. The importer can skip previously imported issues in the same team.

Check the handoff edge case

Assignee names that do not match the destination workspace can lose intended ownership. Check the mapping on imported sample rows.

Sources and verification

Based on product documentation checked on 2026-10-24. This is a documentation-based guide, not a hands-on benchmark. Features and availability can change.

Frequently asked questions

Spend less time on setup, more on decisions

Vantage connects your tools and generates specs grounded in real data. Free to start.

Spec to tickets

Working in Linear? Turn your spec into dependency-ordered tickets.

Paste the feature or spec. Vantage pulls out the requirements and breaks them into tickets, ordered by what blocks what, ready to groom with your team.

0 / 8,000

Where do your tickets live? (optional)

How this works

  1. We save what you typed. No AI runs on this page.
  2. You create a free account.
  3. Vantage builds a PRD and dependency-ordered tickets from it inside your own workspace.

Why ask for an account? We’re a small team, and a full generation runs a multi-step AI pipeline that costs us real money. So we tie it to a free account instead of running it anonymously. You also get to keep the result and edit it.

Your text is only used to create your project, and it stays private to your account. If you don’t sign up, we delete it after 7 days. Privacy policy

Free to start. No credit card required.

Related reading