Importing Issues from CSV
Introduced in GitLab 11.7.
Issues can be imported to a project by uploading a CSV file. Supported fields are
The user uploading the CSV file will be set as the author of the imported issues.
Note: A permission level of
Developeror higher is required to import issues.
To import issues:
- Ensure your CSV file meets the file format requirements.
- Navigate to a project's Issues list page.
- If existing issues are present, click the import icon at the top right, next to the Edit issues button.
- For a project without any issues, click the button labeled Import CSV in the middle of the page.
- Select the file and click the Import issues button.
The file is processed in the background and a notification email is sent to you once the import is completed.
CSV File Format
CSV files must contain a header row beginning with at least two columns,
description, in that order.
If additional columns are present, they will be ignored.
The column separator is automatically detected from the header row.
Supported separator characters are: commas (
,), semicolons (
;), and tabs (
Lines ending in either
LF are supported.
The double-quote (
") character is used to quote fields so you can use the column separator within a field. To insert
a double-quote (
") within a quoted field, use two double-quote characters in succession, i.e.
After the header row, succeeding rows must follow the same column order. The issue title is required while the description is optional.
The limit depends on the configuration value of Max Attachment Size for the GitLab instance.
For GitLab.com, it is set to 10 MB.
title,description My Issue Title,My Issue Description Another Title,"A description, with a comma" "One More Title","One More Description"