Fix import errors
When an import finishes COMPLETE WITH ERRORS, INVALID or FAILED, open the errors from Ingest → Metadata by clicking the state badge or View errors.
The panel is titled Errors for: your file name. A red notice at the top reports a fatal problem with the whole file, if there was one. Below it, one card per release lists each error with the row number in your CSV, the release code and, where relevant, the track number.
Common causes
| Message points at | Check |
|---|---|
| A mandatory column | LIBRARY: Name, ALBUM: Code, ALBUM: Title, ALBUM: Release Date, TRACK: Title, TRACK: Description, TRACK: Number, TRACK: Is Main, TRACK: Audio Filename and the first writer and publisher columns must have values |
| A date | ALBUM: Release Date must be YYYY-MM-DD |
| Track numbers | Mains need whole numbers, unique within the album; versions need TRACK: Is Main = N, a TRACK: Main Track Number pointing at their main, and a TRACK: Version |
| Version numbers | In a file with a TRACK: Version Number column, TRACK: Number and TRACK: Version Number must be whole numbers: a track that breaks this doesn’t import, and the rest of its album does. In either format, two rows that point at the same track (such as 4.6 and 4.06 in the older format) stop the album importing |
| Shares | Percentages without the % symbol |
| Column headers | Exact spelling and a single space after the final colon, for example WRITER:2: First Name |
Fix and reimport
- Correct the rows in your CSV. Keep the release and track codes the same so the reimport updates rather than duplicates.
- Upload the file again from Ingest → Metadata. Releases that imported the first time are updated; the failed ones are created.
Releases with No file or Failed audio are not import errors; they are asset problems. See Deliver audio and artwork.