debian-mirror-gitlab/doc/user/project/repository/csv.md

---
stage: Create
group: Source Code
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
type: reference
---

# CSV files **(FREE)**

> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/14174) in GitLab 14.1.

A comma-separated values (CSV) file is a delimited text file that uses a comma to separate values.
Each line of the file is a data record. Each record consists of one or more fields, separated by
commas. The use of the comma as a field separator is the source of the name for this file format.
A CSV file typically stores tabular data (numbers and text) in plain text, in which case each line
has the same number of fields.

The CSV file format is not fully standardized. Other characters can be used as column delimiters.
Fields may or may not be surrounded to escape special characters.

When added to a repository, files with a `.csv` extension are rendered as a table when viewed in
GitLab.

![CSV file rendered as a table](img/csv_file_rendered_as_table_v14_1.png)
New upstream version 14.1.7+ds1 2021-09-30 23:02:18 +05:30			`---`
			`stage: Create`
			`group: Source Code`
			`info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments`
			`type: reference`
			`---`

			`# CSV files (FREE)`

			`> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/14174) in GitLab 14.1.`

			`A comma-separated values (CSV) file is a delimited text file that uses a comma to separate values.`
			`Each line of the file is a data record. Each record consists of one or more fields, separated by`
			`commas. The use of the comma as a field separator is the source of the name for this file format.`
			`A CSV file typically stores tabular data (numbers and text) in plain text, in which case each line`
New upstream version 15.1.3+ds1 2022-07-23 23:45:48 +05:30			`has the same number of fields.`
New upstream version 14.1.7+ds1 2021-09-30 23:02:18 +05:30
			`The CSV file format is not fully standardized. Other characters can be used as column delimiters.`
			`Fields may or may not be surrounded to escape special characters.`

			When added to a repository, files with a `.csv` extension are rendered as a table when viewed in
			`GitLab.`

			`![CSV file rendered as a table](img/csv_file_rendered_as_table_v14_1.png)`