Summary

CSV import fails with "The first header row of the CSV import file contains following errors for the field name <'Custom field'>: 'brackets mismatch'"

Environment

Jira cloud

Cause

The error occurs when there is a custom field in Jira with a name containing unmatched brackets, and the same inconsistency is present in the CSV file that is used to import. During the import process, Jira fails to recognize the custom field due to the mismatched brackets.
Example custom field:  New Field] BI Project
In the above example, the ] bracket is causing the issue.

Solution

• Access Jira's custom fields settings to identify the field causing the issue.
• Note down the exact name of the custom field with the mismatched brackets.
• Edit the custom field name in Jira to remove the extra or unmatched bracket(s).
• Ensure that the name matches with the field in the CSV file after correction.

• Attempt to import the updated CSV file into Jira.