CSV template

Working with CSV (Comma-Separated Values) files is important to follow a few basic guidelines and avoid typical errors so the data can be imported and processed correctly. Below is a simplified overview of best practices and common pitfalls.

Rules for CSV files

• Each value in a row should be separated by a comma. If a value includes a comma, it must be wrapped in double quotes.
• All rows should follow the same structure and contain the same number of columns to prevent import issues.
• Including a header row at the top of the file is recommended to clearly define what each column represents.
• Text fields that contain special characters such as commas or line breaks should be enclosed in double quotes.
• The file should be saved using UTF-8 encoding to ensure compatibility across different systems.
• Leading or trailing spaces in values should be avoided, as they can cause parsing problems.
• Each record should appear on its own line, and line breaks inside a field should only be used if the field is quoted.

Common mistakes

• Using different separators, such as commas and semicolons, within the same file can lead to incorrect data interpretation.
• Leaving out quotes for fields that contain commas may break the column structure.
• Empty rows can cause errors during data import.
• Inconsistent data formats, such as mixed date styles, may result in processing issues.
• Improper handling of special characters like quotation marks or new lines can corrupt the file.
• Saving the file with the wrong extension, instead of .csv, can prevent it from being recognized correctly.
• Very large CSV files may be hard to process and can exceed system or application limits.

Following these recommendations helps ensure your CSV files are clean, consistent, and easy to import without errors.