What happens when you submit an import
When you upload a file on the Import page, the column-mapping step runs in a browser overlay powered by OneSchema. Once you confirm the mapping, the file is submitted and processing starts in the background. You are immediately returned to the Import page, where a "Past imports" table shows the new row with a status of "In Progress."
Processing happens asynchronously. The status column updates to "Success" or "Failed" when processing finishes. The page automatically refreshes import status in real time, so you do not need to reload.
Reading the past imports table
The table on the Import page shows one row per import with these columns:
Date - when the import was submitted
Import Type - contacts, donations, pledges, or interactions
Status - In Progress, Success, or Failed
Rows with Errors - if the import succeeded but some rows were rejected, a link appears here to download an Excel file listing only those rows and the reason each was rejected. This link is available for seven days after the import.
Contacts - the count of people created or updated
Original File - a link to download the original file you uploaded, available for seven days
Load to List - appears on successful imports with at least one contact; clicking "Create A List" takes you to a view filtered to contacts from that import
When some rows were rejected (partial success)
An import can show "Success" even if some rows were not processed. OneSchema validates each row against the column rules before submission; rows that fail validation are counted separately and not sent for processing. After processing, the "Rows with Errors" column shows the error count and, if the link is available, an Excel file you can download.
To fix those rows:
Download the error file from the "Rows with Errors" link.
Open it and review the error reason for each row.
Correct the data in your original spreadsheet.
Run a new import with only the corrected rows.
There is no button to re-process just the failed rows from a previous import. You re-import the corrected data as a new upload.
When an entire import fails
If the Status column shows "Failed," the import did not process any rows. Common causes:
The file was empty or had no valid data rows after validation.
A system error occurred during processing (for example, a temporary service outage).
To recover, fix or prepare your file and start a new import from the Import page. There is no retry button on a failed import row.
When the status stays "In Progress" for a long time
Large files take longer to process because rows are handled in batches. If an import appears stuck, wait a few minutes and then reload the page. If the status has not changed after an extended period, contact support.
Preventing errors before you upload
The column-mapping step (the OneSchema overlay) runs basic validation before the file is submitted. Common issues caught at this stage include missing required columns, unrecognized date formats, and invalid phone numbers. Resolve all validation warnings in the overlay before clicking to finalize the upload. Rows that do not pass validation at this stage are not submitted and will not appear in the error file.