diff options
| author | Mike Lewis <mlewis@gitlab.com> | 2019-05-19 19:54:46 +0000 |
|---|---|---|
| committer | Mike Lewis <mlewis@gitlab.com> | 2019-05-19 19:54:46 +0000 |
| commit | 5fb7ef1729f9b4d9198c7441557e71e6da9952d6 (patch) | |
| tree | c34d7fa6bd357f1a372f5c59edc3548def2a7271 | |
| parent | ee48f60518eed270d3272844b9f6d8b35087bbbc (diff) | |
| parent | c44a2fdbed4e62ae598c9c82c4cb7648994e3868 (diff) | |
| download | gitlab-ce-5fb7ef1729f9b4d9198c7441557e71e6da9952d6.tar.gz | |
Merge branch 'docs-import-csv' into 'master'
In CSV Import doc, clarified order of column headers and recommended test import
Closes #60622
See merge request gitlab-org/gitlab-ce!28449
| -rw-r--r-- | doc/user/project/issues/csv_import.md | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/doc/user/project/issues/csv_import.md b/doc/user/project/issues/csv_import.md index 032e3a73ad0..b0b1cfcfdf7 100644 --- a/doc/user/project/issues/csv_import.md +++ b/doc/user/project/issues/csv_import.md @@ -1,17 +1,23 @@ -# Importing Issues from CSV +# Importing issues from CSV > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/23532) in GitLab 11.7. -Issues can be imported to a project by uploading a CSV file. Supported fields are -`title` and `description`. +Issues can be imported to a project by uploading a CSV file with the columns +`title` and `description`, in that order. The user uploading the CSV file will be set as the author of the imported issues. > **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](#csv-file-format) requirements. + +## Import the file + To import issues: -1. Ensure your CSV file meets the [file format](#csv-file-format) requirements. 1. Navigate to a project's Issues list page. 1. If existing issues are present, click the import icon at the top right, next to the **Edit issues** button. 1. For a project without any issues, click the button labeled **Import CSV** in the middle of the page. @@ -20,11 +26,11 @@ To import issues: The file is processed in the background and a notification email is sent to you once the import is completed. -## CSV File Format +## CSV file format ### Header row -CSV files must contain a header row beginning with at least two columns, `title` and `description`, in that order. +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. ### Column separator @@ -53,7 +59,7 @@ The limit depends on the configuration value of Max Attachment Size for the GitL For GitLab.com, it is set to 10 MB. -## Sample Data +## Sample data ```csv title,description |