Backlog 101: Batch Import

Batch import allows you to quickly add multiple issues to Backlog at once by uploading a CSV file.

In this overview, we’ll go over how to:

• Download a template
• Add issue properties to your file
• Batch import your issues

Download a template

If you don’t have a CSV file prepared, you can download a template with all the required headers for inputting issue information. To download a template:

• Select “Batch import” on the issues list page.
• Select “Download template.”

Add issue properties to your file

The batch import feature allows you to input all issue properties (except issue status) and custom fields into the CSV file. You can leave out any properties you don’t need. The properties to include in your CSV file depend on the project settings, much like the standard "Add issue" functionality.

• Dates: To specify start date, due date, and custom field dates, use hyphens (e.g., 03-27-2025).
• Multiple values: Properties that support multiple values in the standard “Add issue” function can also include multiple values in the CSV file. Separate them with commas.
• Parent Issue: Parent issues can be specified in the CSV, but they must also be included in the same file. To set a parent issue, input the subject of the issue you want to designate as the parent issue.

Batch import your issues

1. Select “Batch import” on the issues list page.
2. Upload your CSV file.
3. Fix any errors and re-upload the file.
4. Reassign property values to those in the project if needed.
5. Review the issues to be imported.
6. Select “Start import.”

Large imports will take longer, and progress is shown in the “Import in progress” dialog.

CSV Example

The following example contains a subset of the issue properties.