Some metadata errors can be easily fixed. This article outlines what to do if you're having trouble ingesting.
First, run the Metadata validator on the metadata .TXT file for the album you are having trouble ingesting.
If the Metadata validator displays the message 'File is valid.', then the issue is likely to be corrupt .WAV files. Please contact email@example.com for a quick response to solve these issues.
If the Metadata validator displays another message, the issue is likely within the metadata file.
Below is a list of these errors, and how you can easily fix them:
- Line breaks
A very common issue with metadata is the presence of invisible line breaks. Line breaks are where a cell in your spreadsheet is 'broken' across two lines, made with 'Control + Enter' or 'Command + Return'.
Fix: These are so common, we have written a whole article about them: Removing Linebreaks from Metadata.
- Incorrect column headers
If the metadata validator displays the following message:
Fix: Match your column headers exactly to those in the Metadata template exactly. We suggest that you do this by:
- Copying and pasting the headers from our Metadata template.
- Retyping any additional headers from the template, e.g. COM:2:... columns headers.
- All headers are mandatory and cannot be changed. It is safe to leave fields blank for optional columns.
- Empty mandatory cells
Be sure that all mandatory cells are populated in your metadata. A full list of mandatory columns can be found in our Metadata guide.
- Invalid characters
Fix: Make sure you do not have invalid characters in the row and column specified. Here, the issue is that the COM 1:P % Share column has "%" for the first track.
- Incorrect file names
This message will be displayed where the Filenames column does not match the actual name of the files in the Album folder, or where the folder does not contain both metadata and the .wav files.
Fix: Check the .txt file and .wav files are in the same folder. Copy the filenames from your Finder window into your metadata .txt file, or alternatively, replace the filenames for the .wav files with the data from the Filenames column, by copying and pasting.
- Invalid length
Fix: Check that the 'Length' column, specifying the track's duration, is set as a 'General' cell, rather than Time. Additionally, make sure it is either in seconds (e.g. "108") or mm:ss (e.g. 01:48) format.
- Unnecessary and optional columns (e.g. REG columns)
Some columns are not required to exist, and if they are not populated, need to be removed from your file.
If this message is displayed, you need to remove the columns specified:
Fix: If some tracks have data for the specified columns, make sure they are filled correctly. For example, make sure all other tracks have 'N' in the REG:I Include column.
If they aren't populated, and you don't need them, then delete these columns from the file.
- Invisible data after track rows
Sometimes your file will contain data in the final row. This will appear as the following error. Note that there is no actual file name specified, it is just a folder path and '.wav' at the end:
- Click the start of the row which is returning the error.
- Right click + 'Clear contents' or hit Delete. This will clear any invisible data.