Skip to content

Import issues from CSV

You will learn how to import issues into a project from a CSV file, including spreadsheets exported from tools such as Jira or Linear.

CSV import is a project workflow. Only project admins (or workspace owners and admins) can run it. For a full Jira Cloud API migration, use Import from Jira Cloud instead.

1. Open CSV import

  1. Open the target project.
  2. Open the project overflow menu and choose CSV import.

If you lack permission, Tixio explains that only project admins or workspace owners/admins can import issues from CSV.

2. Upload a file

  1. Choose a .csv file (server size limits apply; expect on the order of tens of MiB).
  2. Wait for the upload confirmation that asks you to map columns.

There are no built-in Jira or Linear presets — map columns manually from whatever headers your export used.

3. Map columns

Map CSV headers to Tixio fields:

Field Notes
Title Required
Description Optional
Priority Optional
Status name Optional
Assignee email Optional
Labels (comma-separated) Optional
Due date Optional
Estimate Optional

Choose Save mapping, then Preview 10 rows to verify the mapping before you commit.

4. Run the import

  1. Choose Run import.
  2. Watch status and counts (total rows, succeeded, failed).
  3. Fix the CSV or mapping if rows fail, then upload again with Upload a different file if needed.

When to use CSV vs Jira Cloud

Situation Prefer
One-shot Jira Cloud project with comments, attachments, epics, versions Import from Jira Cloud
Flat issue list from Linear, Jira CSV export, or a spreadsheet This CSV import
Full workspace archive restore Export and import workspace data

Next