You can export issues from GitLab to a plain-text CSV (comma-separated values) file. The CSV file is attached to an email, and sent to your default notification email address.
CSV files can be used with any plotter or spreadsheet-based program, like Microsoft Excel, OpenOffice Calc, or Google Sheets. Use a CSV list of issues to:
- Create a snapshot of issues for offline analysis, or to share with other teams who might not be in GitLab.
- Create diagrams, graphs, and charts from the CSV data.
- Convert the data to other formats for auditing or sharing.
- Import the issues to a system outside of GitLab.
- Analyze long-term trends with multiple snapshots created over time.
- Use the long-term data to gather relevant feedback given in the issues, and improve your product based on real metrics.
You can export issues from individual projects, but not groups.
- You must have at least the Reporter role.
- On the left sidebar, select Search or go to and find your project.
- Select Plan > Issues.
- Above the list of issues, select Search or filter results….
- In the dropdown list that appears, select the attributes to filter by. For more information about filter options, see Filter the list of issues.
- In the upper right, select Actions () > Export as CSV.
- In the dialog, verify that the email address is correct, then select Export issues.
All matching issues are exported, including those not shown on the first page. The exported CSV does not contain attachments from issues.
The CSV file has this format:
- Sort is by title.
- Columns are delimited with commas.
- Fields are quoted with double quotes (
") if needed.
- Newline characters separate rows.
The following columns are included in the CSV file.
|Issue ID||Issue |
|URL||A link to the issue on GitLab|
|Author||Full name of the issue author|
|Author Username||Username of the author, with the |
|Assignee||Full name of the issue assignee|
|Assignee Username||Username of the author, with the |
|Due Date||Formatted as |
|Created At (UTC)||Formatted as |
|Updated At (UTC)||Formatted as |
|Milestone||Title of the issue milestone|
|Labels||Labels, separated by commas|
|Time Estimate||Time estimate in seconds|
|Time Spent||Time spent in seconds|
|Epic ID||ID of the parent epic|
|Epic Title||Title of the parent epic|
When working with exported issues, you might encounter the following issues.
In GitLab 14.7 and earlier, the first two columns in exported files were
Issue ID and
which caused problems importing data back into GitLab. For more information, see
Issues are sent as an email attachment, with a 15 MB export limit to ensure successful delivery across a range of email providers. If you reach the limit, narrow your search before export. For example, consider exporting open and closed issues separately.