Skip to content
atlcli

Import/Export

Import/Export

Section titled “Import/Export”

Import and export issues in CSV and JSON formats.

Prerequisites

Section titled “Prerequisites”
  • Authenticated profile (atlcli auth login)
  • Jira permission: Browse Projects (export), Create Issues (import)

Export

Section titled “Export”

Export to CSV

Section titled “Export to CSV”
Terminal window
atlcli jira export --jql "project = PROJ" --format csv -o issues.csv

Export to JSON

Section titled “Export to JSON”
Terminal window
atlcli jira export --jql "project = PROJ" --format json -o issues.json

Export Options

Section titled “Export Options”
FlagDescription
--jqlJQL query to select issues
--formatOutput format (csv, json)
-oOutput file
--fieldsFields to include

Import

Section titled “Import”

Import from CSV

Section titled “Import from CSV”
Terminal window
atlcli jira import --file issues.csv --project PROJ

Import from JSON

Section titled “Import from JSON”
Terminal window
atlcli jira import --file issues.json --project PROJ

Import Options

Section titled “Import Options”
FlagDescription
--fileInput file
--projectTarget project
--dry-runPreview without creating
--map-fieldField mapping overrides

CSV Format

Section titled “CSV Format”

Required columns:

  • summary - Issue title

Optional columns:

  • type - Issue type
  • description - Issue description
  • priority - Priority name
  • labels - Semicolon-separated labels
  • components - Semicolon-separated components

Field Mapping

Section titled “Field Mapping”

Map CSV columns to Jira fields:

Terminal window
atlcli jira import --file data.csv --map-field "Title=summary" --map-field "Bug Type=issuetype"
Section titled “Related Topics”
Jira and Confluence are trademarks of Atlassian Corporation Plc. atlcli is not affiliated with, endorsed by, or sponsored by Atlassian.