Fixing “Could not parse” errors during contact upload
Click here for a complete list of contact upload errors and how to fix them!
If your contact upload fails with an error that starts with “Could not parse…”, it usually means one or more values in your spreadsheet don’t match the format Message expects.
You’ll fix this in two steps:
Check what format the field requires in Message
Update your spreadsheet to match, then re-upload
Step 1: Confirm the required format in Message
In Message, go to Programs → Manage Fields.
Find the field listed in the error message.
-
Match your spreadsheet column header to the Variable name column in Manage Fields.
Example: If your spreadsheet header is
birth_date, look forbirth_dateunder Variable name.
Check the field’s Type to see how the data must be formatted.
Scroll to the bottom of the page for the Field Types glossary (definitions + examples).
Different field types, their definitions, and examples
Most common fixes
The majority of “Could not parse” issues come from:
Date fields
Boolean fields (True/False)
Fix 1: Date fields (must be YYYY-MM-DD)
A very common issue is dates formatted in Excel’s default MM/DD/YYYY, but Message requires YYYY-MM-DD.
In Excel:
Open the spreadsheet and select the date column (click the column letter).
Right-click → Format Cells
Under Category: Date, choose a Year-Month-Day format with dashes (looks like
2012-03-14).Click OK.
Repeat for any other date columns, save the file, and re-upload.
Fix 2: Boolean fields (must be only TRUE or FALSE)
Boolean fields accept only TRUE or FALSE. Values like Yes/No, Y/N, 1/0, or mixed capitalization can cause a parse error.
Replace incorrect values in bulk (Excel):
Select the Boolean column (click the column letter).
Open Find & Replace (magnifying glass or Ctrl/Cmd + F), then choose Replace.
In Find what, enter a variation you have (e.g.,
yes).In Replace with, enter
TRUE(orFALSEas needed).Click Replace All.
Repeat for other variations (e.g.,
Yes,YES,true,True, etc.), then do the same forFALSE.
Verify with a filter:
Select the Boolean column.
Go to Sort & Filter → Filter.
-
Open the filter dropdown and confirm the only values present are
TRUEandFALSE.If anything else appears, repeat the Replace steps until only those two values remain.
Before you re-upload (quick check)
All dates use
YYYY-MM-DDBoolean columns contain only
TRUEorFALSEFile is saved as .csv and ready to import again
Comments
Please sign in to leave a comment.