2.6 KiB
2.6 KiB
| stage | group | info |
|---|---|---|
| none | unassigned | To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers |
Importing issues from CSV
Introduced in GitLab 11.7.
Issues can be imported to a project by uploading a CSV file with the columns
title and description.
The user uploading the CSV file will be set as the author of the imported issues.
NOTE: Note: A permission level of Developer, or higher, is required to import issues.
Prepare for the import
- Consider importing a test file containing only a few issues. There is no way to undo a large import without using the GitLab API.
- Ensure your CSV file meets the file format requirements.
Import the file
To import issues:
- 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 complete.
CSV file format
When importing issues from a CSV file, it must be formatted in a certain way:
- header row: CSV files must include the following headers:
titleanddescription. The case of the headers does not matter. - columns: Data from columns beyond
titleanddescriptionare not imported. - separators: The column separator is automatically detected from the header row.
Supported separator characters are: commas (
,), semicolons (;), and tabs (\t). The row separator can be eitherCRLForLF. - double-quote character: The double-quote (
") character is used to quote fields, enabling the use of the column separator within a field (see the third line in the sample CSV data below). To insert a double-quote (") within a quoted field, use two double-quote characters in succession, i.e."". - data rows: After the header row, succeeding rows must follow the same column order. The issue title is required while the description is optional.
Sample CSV data:
title,description
My Issue Title,My Issue Description
Another Title,"A description, with a comma"
"One More Title","One More Description"
File size
The limit depends on the configuration value of Max Attachment Size for the GitLab instance.
For GitLab.com, it is set to 10 MB.