Skip to content

Import/Export

Import and export issues in CSV and JSON formats.

  • Authenticated profile (atlcli auth login)
  • Jira permission: Browse Projects (export), Create Issues (import)
Terminal window
atlcli jira export --jql "project = PROJ" --format csv -o issues.csv
Terminal window
atlcli jira export --jql "project = PROJ" --format json -o issues.json
Flag Description
--jql JQL query to select issues
--format Output format (csv, json)
-o Output file
--fields Fields to include
Terminal window
atlcli jira import --file issues.csv --project PROJ
Terminal window
atlcli jira import --file issues.json --project PROJ
Flag Description
--file Input file
--project Target project
--dry-run Preview without creating
--map-field Field mapping overrides

Required columns:

  • summary - Issue title

Optional columns:

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

Map CSV columns to Jira fields:

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