-
Notifications
You must be signed in to change notification settings - Fork 514
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.
- Navigate to Admin → CSV Import
- Upload your CSV file
- Map your CSV columns to ChurchCRM fields
- Review and import
- Title, First Name, Middle Name, Last Name, Suffix
- Gender
- Birth Date, Membership Date, Wedding Date
- Address1, Address2, City, State, Zip, Country
- Home Phone, Work Phone, Mobile Phone
- Email, Work/Other Email
- Donation Envelope number
- Custom Person Fields
- Custom Family Fields
Dates can be formatted as:
-
YYYY-MM-DD(recommended) MM-DD-YYYYDD-MM-YYYY
The separator (dash, slash, etc.) doesn't matter.
- 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
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
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.
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.
- Installation Guide ← Start here!
- First Run Setup
- Features Overview
Day-to-day usage of ChurchCRM
- User Documentation
- People Management
- Groups & Events
- Tools
- Finances
Server management & configuration
- User Management
- System Maintenance
- Configuration
- Troubleshooting
- Localization
Contributing to ChurchCRM
- Quick Start
- Testing & CI/CD
- Code & Architecture
- Localization
- Release & Security