Data Import
ChurchCRM can import member data from CSV (comma-separated value) files, making it easy to migrate from another system or import a membership list.
Important: Test your import first! It's easier to fix issues in your CSV file than in ChurchCRM.
Getting Started​
- Navigate to Admin → CSV Import
- Upload your CSV file
- Map your CSV columns to ChurchCRM fields
- Review and import
Supported Fields​
Personal Information​
- Title, First Name, Middle Name, Last Name, Suffix
- Gender
- Birth Date, Membership Date, Wedding Date
Contact Information​
- Address1, Address2, City, State, Zip, Country
- Home Phone, Work Phone, Mobile Phone
- Email, Work/Other Email
Church-Specific​
- Donation Envelope number
- Custom Person Fields
- Custom Family Fields
Date Formats​
Dates can be formatted as:
YYYY-MM-DD(recommended)MM-DD-YYYYDD-MM-YYYY
The separator (dash, slash, etc.) doesn't matter.
Tips for Successful Imports​
- Clean your data first - It's easier to fix issues in Excel/Sheets than in ChurchCRM
- Use the "Clear Data" option - When testing, use this to start fresh between attempts
- Don't rush - Take time to properly map fields before importing
After importing, you can make corrections in ChurchCRM:
- Move someone to a different family by editing their Person record
- Assign family roles (head, spouse, child) to help with address labels
Automatic Family Generation​
ChurchCRM can automatically create Family records during import using one of two methods:
| Method | Best For |
|---|---|
| Same Last Name + Address | Traditional families at the same address |
| Custom Family Field | Pre-assigned family IDs or non-traditional families |
To enable automatic family generation:
- Check the box next to the family generation dropdown
- Select your preferred method
- The system will group people into families automatically
Setting Classifications During Import​
To assign classifications efficiently:
- Separate your data into multiple files by classification type
- Import each file separately, selecting the appropriate classification
- Example workflow:
- Import
members.csvwith classification "Member" - Import
visitors.csvwith classification "Guest" - Import
regular-attenders.csvwith classification "Regular Attender"
- Import
This is much faster than manually classifying each person after import.
Troubleshooting​
Import Shows 0 Rows on Shared Hosting​
If you're on shared hosting and the import shows 0 rows, this is likely a file permission issue. Contact your hosting provider or system administrator to ensure the temp directory is writable.