Import & Export

Bring existing data into Velocity with CSV or JSON import, and export your issues and projects for backup or analysis.

Importing Data

Go to Settings → Import to open the import wizard. Velocity supports two import formats: CSV files and JSON data.

CSV Import

Supported CSV columns:

JSON Import

Alternatively, paste JSON data directly into the import wizard. The JSON should be an array of issue objects:

[
  {
    "title": "Fix login bug",
    "description": "Users cannot log in with SSO",
    "priority": "HIGH"
  },
  {
    "title": "Update onboarding flow",
    "priority": "MEDIUM"
  }
]

Import from Linear

A workspace owner can open Settings → Import → Linear to migrate teams, workflow statuses, labels, projects, cycles, issues, comments, sub-issue relationships, and attachments. This is an import, not ongoing synchronization.

1. Click Connect with Linear to authorize read access. OAuth credentials stay on the Velocity server. Alternatively, expand Use a personal API key instead; this key stays in memory for the import and is not saved.
2. Select the Linear teams you want to import, then click Review mappings.
3. Review each destination before starting. Suggested matches are editable and the importer uses the choices you review.
4. Use Run dry run to check your choices without importing data, or Start import to create the imported records. Keep the tab open until progress finishes.

The review belongs to the connected Linear organization. If you change accounts or select different teams, load and review the mappings again before importing. A dry run records the import attempt but does not create imported issues or related data.

Review import results

Parent links are restored after importing the selected teams, including parents in another selected team or already imported into this workspace. Parents outside the imported data are reported for review. Existing manually chosen parents are preserved.

Repeating an import skips existing issues and can fill missing comments and parent links. It preserves the existing issues' team, status, assignee, labels, and edited text; new mapping choices apply to issues created by that import.

Files hosted on uploads.linear.app are copied into Velocity storage, subject to limits of 20 MiB per file, 50 files per issue, and 100 MiB per issue. Other safe HTTP or HTTPS attachment links stay as external links. If a file cannot be copied, its original link is preserved and the import reports a warning.

Progress reports parent links, unresolved parents, attachments, and attachment failures alongside the issue and comment counts. Read any Items to reviewbefore treating the migration as complete. If the connection ends before a completion message, inspect the imported data before retrying; an interrupted browser connection does not prove that nothing was written.

Disconnect Linear

The workspace owner can choose Disconnect Linear in the import wizard to revoke the connection and remove its stored credentials. Imported issues, comments, and files stay. If Velocity reports that revocation failed, remove its authorization in Linear's application settings too.

Exporting Data

Go to Settings → Export to download your workspace data.

Export Options

Click Export to generate and download the file. Large exports may take a few seconds to prepare.

CSV Export Format

Exported CSV files include a header row and one row per issue or project. All fields are included: ID, identifier, title, description, status, priority, assignee, labels, dates, and more.

JSON Export Format

JSON exports produce an array of objects matching the GraphQL schema, making them easy to process programmatically or re-import into another workspace.