This documentation relates to CiviCRM version 3.1. It's not maintained anymore.
Current version of documentation.

Import Errors

Skip to end of metadata
Go to start of metadata

This page refers to outdated version of CiviCRM. Check current version of documentation.

Documentation Search

CiviCRM 3.1 Documentation

Support and Participation

Developer Resources

CiviCRM book!

Make sure to check out Understanding CiviCRM as well! You can also support this project by ordering a hard copy.

Common Import Errors

Most import errors are a result of invalid formatting or unexpected data.

Whenever there is an error/problem with a particular record row, the Import Errors file shows a row for that record which starts with the Record Number (so you can find the problem record in the original file), and the next column is "Reason" - the reason the record was rejected.

For example, if there is an error with date formatting, the Reason for all rows with that errror will be shown as: "Invalid value for field(s) : Receive Date".

When you get an error during an import, check for these common errors:

Invalid Formatting

Invalid formatting

Correct Formatting




May 2, 2007

2nd May 2007


mary at



Unexpected Data


Unexpected Data

Expected Data



Jose Martinez


mary at

Contribution Type


Donation, Member Dues, etc.

Membership Type


Annual, Lifetime, etc.

Contribution, Membership or Participant Import - No Matching Contact

Importing contributions, memberships or event participant records require that a contact record already exists. The contribution etc. is matched to the contact making the contribution during the import. If no matching contact is found, the Reason for the import error will look like this:

"No matching Contact found for (Jane Doe )"

Membership Import - Required Parameter Missing 

Membership record imports must have a membership type field containing data that is consistent with the membership types defined in the CiviCRM administration > CiviMember > membership types page. Missing data or non-matching data will yield a "required parameter missing" error after attempted import.

  • None

Creative Commons License
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-Share Alike 3.0 United States Licence.