// guide
Import releases from CSV
Use CSV import to bulk-load historical releases into Traken. Useful when migrating from a spreadsheet or backfilling release history.
Prerequisites: You must be logged in and belong to a workspace.
File format
Your CSV must include a header row. Accepted columns:
| Column | Required | Notes |
|---|---|---|
| title | Yes | Short release name |
| released_at | Yes | ISO 8601 or "YYYY-MM-DD" or "YYYY-MM-DD HH:MM" |
| team | No | Team tag |
| subsystem | No | Subsystem tag |
| description | No | Free text |
Minimal valid example:
title,released_at v1.0.0,2024-01-15 Payments fix,2024-02-03 14:30
Steps
- 1Open the Feed page.
- 2Click Import CSV.
- 3Read the format instructions, then click Choose file and select your
.csvfile (max 5 MB). - 4Traken shows a preview of all rows. Rows with missing required fields or unparseable dates are flagged inline — they will be skipped on import.
- 5Review the summary line ("X releases ready to import, Y rows will be skipped").
- 6Click Import to save the valid rows. The feed updates immediately.
Errors
Rows are flagged individually. Common causes:
titleis emptyreleased_atis missing or not a recognisable date format
Extra columns are ignored — they do not cause errors.