diff options
Diffstat (limited to 'doc/user/project/issues/csv_import.md')
-rw-r--r-- | doc/user/project/issues/csv_import.md | 58 |
1 files changed, 22 insertions, 36 deletions
diff --git a/doc/user/project/issues/csv_import.md b/doc/user/project/issues/csv_import.md index e1e58e5ab24..cc0d5ac9028 100644 --- a/doc/user/project/issues/csv_import.md +++ b/doc/user/project/issues/csv_import.md @@ -29,42 +29,22 @@ to you once the import is complete. ## CSV file format -Sample CSV file data: - -CSV files must contain a header row where the first column header is `title` and the second is `description`. -If additional columns are present, they will be ignored. - -### Header row - -CSV files must contain a header row beginning with at least two columns, `title` and -`description`, in that order. If additional columns are present, they will be ignored. - -### 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 either `CRLF` or `LF`. - -### 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](#csv-file-format)). -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. - -### 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. - -## Sample data +When importing issues from a CSV file, it must be formatted in a certain way: + +- **header row:** CSV files must contain a header row where the first column header + is `title` and the second is `description`. If additional columns are present, they + will be ignored. +- **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 either `CRLF` or `LF`. +- **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: ```csv title,description @@ -72,3 +52,9 @@ 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. |