Import / Export
Axoria supports bulk issue import and export via CSV and Excel (.xlsx), with a 4-step wizard that ensures accurate column mapping and validation before any data is saved.
Exporting Issues
-
In the project, go to Issues → Export (or the Export button on the board/table).
-
Configure optional filters:
Filter Description Status Export only issues in specific statuses Type Filter by issue type Priority Filter by priority Sprint Export issues from a specific sprint Assignee Export issues assigned to a specific user -
Select the format: CSV or XLSX.
-
Click Export. The file downloads immediately.
Exported Fields
| Column | Description |
|---|---|
key |
Issue key (e.g., SHOP-42) |
title |
Title |
description |
Description (plain text, no Markdown) |
type |
Issue type |
priority |
Priority |
status |
Current status |
assignees |
Assignees (comma-separated) |
story_points |
Story Points |
story_id |
Story ID |
sprint |
Associated sprint name |
labels |
Labels (comma-separated) |
due_date |
Due date |
created_at |
Creation timestamp |
updated_at |
Last update timestamp |
Importing Issues
Step 1 - Upload
- Go to Issues → Import.
- Upload your CSV or XLSX file.
- The system auto-detects the delimiter (CSV) and shows a preview of the first rows.
- Click Next.
Step 2 - Column Mapping
The system shows all columns detected in the file. For each column, select the corresponding Axoria field:
| File Column | Axoria Field |
|---|---|
title |
title (required) |
type |
type |
priority |
priority |
assignee |
assignees |
| ... | ... |
Columns that don't match any field can be ignored.
Click Next.
Step 3 - Validation
The system validates each row and displays:
- Valid rows - ready to import
- Rows with errors - with details of the problem (invalid field, unknown value, etc.)
You can edit rows with errors directly on screen before proceeding, or choose to skip invalid rows and import only valid ones.
Click Next.
Step 4 - Confirmation
Import summary:
- Total rows
- Issues to create
- Skipped rows (with errors)
Click Confirm Import. Issues are created in file order with automatic sequential keys.
Downloading the Template
On the import screen, click Download Template to get a model file with the correct columns and valid value examples for each field.
Limits
| Limit | Value |
|---|---|
| Maximum file size | 10 MB |
| Rows per import | 5,000 |
| Supported formats | CSV, XLSX (.xlsx) |