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
Upload your file
Drag and drop a .csv file onto the upload area, or click to browse. The file should have a header row with column names.
Preview & map columns
The wizard shows a preview of your data. Verify that columns are correctly detected. At minimum, a title column is required.
Import
Click Import to create issues in bulk. A progress indicator shows the import status. Issues are assigned to the selected team.
Done
Review the results summary showing how many issues were created. Navigate to your issues list to see the imported data.
Supported CSV columns:
| Column | Required | Description |
|---|---|---|
title | Yes | Issue title |
description | No | Issue description (plain text) |
priority | No | URGENT, HIGH, MEDIUM, LOW, or NONE |
status | No | Status name (matched against team statuses) |
assignee | No | Assignee email or display name |
labels | No | Comma-separated label names |
dueDate | No | Due date in ISO 8601 format |
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"
}
]Exporting Data
Go to Settings → Export to download your workspace data.
Export Options
| Option | Description |
|---|---|
| Entity type | Choose what to export: Issues or Projects. |
| Format | Select CSV or JSON output format. |
| Date range | Optionally filter by creation date to export a subset of data. |
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.
Use exports for regular backups, data migration between workspaces, or feeding data into external reporting tools.