Exporting Contacts (CSV) #
Export your contacts to CSV format for backup, analysis, migration, or integration with other systems. PloverCRM’s export feature is flexible, allowing you to export all contacts or filter by specific criteria.
Overview #
CSV export is useful for:
- Creating backups of your contact database
- Analyzing contact data in spreadsheets
- Migrating to another CRM system
- Sharing contact lists with team members
- Importing into email marketing tools
- Generating reports and analytics
- Bulk editing contacts offline
Quick Export #
- Navigate to PloverCRM → Contacts → Import/Export
- Click the Export tab
- Configure export options (or use defaults)
- Click Export CSV
- Download the generated file
Export Time:
- Small lists (< 1,000 contacts): Instant – Medium lists (1,000–10,000): 10–30 seconds – Large lists (> 10,000): 1–2 minutes
Export Options #
Export All Contacts #
Exports all contacts in your CRM, including all standard fields and optionally custom fields, with no filtering applied.
When to use: Complete database backup, full migration to another system, comprehensive data analysis.
- Select the Export tab
- Check Export all contacts
- Check Include custom fields (recommended)
- Click Export CSV
Export Filtered Contacts #
Filter by Lists — export only contacts in specific lists:
- Uncheck “Export all contacts”
- Select “Filter by lists”
- Choose one or more lists
- Contacts in ANY selected list will be exported
Selected Lists: Newsletter, VIP Customers
Result: All contacts in Newsletter OR VIP Customers
Filter by Tags — export only contacts with specific tags:
- Uncheck “Export all contacts”
- Select “Filter by tags”
- Choose one or more tags
- Contacts with ANY selected tag will be exported
Selected Tags: Hot Lead, Enterprise
Result: All contacts tagged Hot Lead OR Enterprise
Filter by Date Range — export contacts created within a date range:
- Uncheck “Export all contacts”
- Select “Filter by date”
- Set “From” and “To” dates
- Only contacts created in this range will be exported
From: 2026-01-01
To: 2026-01-31
Result: All contacts created in January 2026
Combine Filters — multiple filters can be combined:
Lists: Newsletter
Tags: VIP
Date: 2026-01-01 to 2026-01-31
Result: Contacts in Newsletter AND tagged VIP AND created in January
Include Custom Fields #
When checked: All custom field values are included; each custom field becomes a column; empty values show as blank cells.
When unchecked: Only standard fields are exported; smaller file size; faster export.
Recommendation: Always include custom fields for complete backups.
Export File Format #
CSV Structure #
Standard columns (always included):
ID, Email, First Name, Last Name, Phone, City, State, Country, Postal Code, Lists, Tags
With custom fields:
ID, Email, First Name, Last Name, Phone, City, State, Country, Postal Code, Lists, Tags, Company, Job Title, Lead Source, Birthday
Sample Export #
ID,Email,First Name,Last Name,Phone,City,State,Country,Postal Code,Lists,Tags,Company,Job Title
123,[email protected],John,Doe,+1-555-0123,New York,NY,United States,10001,"Newsletter, Customers","VIP, Enterprise",Acme Inc,CEO
124,[email protected],Jane,Smith,+1-555-0124,Los Angeles,CA,United States,90001,Newsletter,"Hot Lead, Tech",Tech Corp,CTO
125,[email protected],Bob,Johnson,+1-555-0125,Chicago,IL,United States,60601,"Newsletter, Leads",Startup,Startup LLC,Founder
Field Formatting #
- Lists and Tags: Comma-separated within quotes — e.g.
"Newsletter, Customers, VIP" - Dates:
YYYY-MM-DD— e.g.2026-02-03 - DateTime:
YYYY-MM-DD HH:MM:SS— e.g.2026-02-03 14:30:00 - Multi-Select Custom Fields: Comma-separated within quotes — e.g.
"Option 1, Option 2, Option 3" - Empty Values: Shown as blank cells (not “null” or “N/A”)
File Encoding #
UTF-8 with BOM ensures proper display in Excel, supports international characters, and is compatible with most spreadsheet applications. Special characters are fully supported: accented letters (José, François), non-Latin scripts (ç”°ä¸, Ù…ØÙ…د), and symbols (€, £, Â¥).
Using Exported Data #
Opening in Excel #
- Download the CSV file
- Open Microsoft Excel
- Go to Data → From Text/CSV
- Select the downloaded file
- Excel auto-detects UTF-8 encoding
- Click Load
Alternative: Double-click the CSV file to open it directly — you may need to adjust column widths.
Opening in Google Sheets #
- Go to Google Sheets
- Click File → Import
- Upload the CSV file
- Select “Replace spreadsheet” or “Insert new sheet”
- Click Import data
Opening in LibreOffice Calc #
- Open LibreOffice Calc
- Go to File → Open and select the CSV file
- In the import dialog, set: Character set: UTF-8, Separator: Comma, Text delimiter:
" - Click OK
Editing and Re-Importing #
- Export contacts to CSV
- Open in spreadsheet application
- Make bulk edits
- Save as CSV (UTF-8)
- Re-import with the “Update Existing” option
Common edits: Update phone numbers, correct email addresses, add custom field data, update company information, assign new lists/tags.
Important: Don’t modify the ID column — it’s used to match existing contacts on re-import.
Advanced Export Scenarios #
Exporting for Backup #
- Export all contacts with custom fields included
- Save with a date in the filename:
contacts-backup-2026-02-03.csv - Store in a secure location
- Schedule regular backups (weekly/monthly)
Backup Checklist:
- ✓ All contacts exported
- ✓ Custom fields included
- ✓ File saved securely
- ✓ Backup tested (can re-import)
- ✓ Multiple backup copies stored
Exporting for Migration #
- Export all contacts with custom fields
- Review the target CRM’s import requirements
- Map PloverCRM fields to target fields
- Adjust CSV column headers if needed
- Test import with a small sample
- Import the full dataset
Field Mapping Example:
PloverCRM → Target CRM
Email → Email Address
First Name → Given Name
Last Name → Family Name
Company (custom) → Company Name
Exporting for Analysis #
- Export filtered contacts (e.g. by date range)
- Open in Excel or Google Sheets
- Create pivot tables
- Generate charts and graphs
- Analyze trends and patterns
Analysis Examples: Contacts by city/state, growth over time, list/tag distribution, custom field statistics, lead source effectiveness.
Exporting for Email Marketing #
- Export contacts from a specific list
- Ensure the email column is present
- Include relevant custom fields
- Remove contacts without an email
- Import into your email marketing tool
Popular Integrations: Mailchimp, Constant Contact, SendGrid, Campaign Monitor
Troubleshooting #
Export Button Not Working #
Problem: Clicking “Export CSV” does nothing.
- Check browser console for JavaScript errors
- Disable browser extensions temporarily
- Try a different browser
- Clear browser cache
- Check if you have export permissions
Export Times Out #
Problem: Export fails with a timeout error for large datasets.
- Export in smaller batches using filters
- Increase PHP
max_execution_time - Contact your hosting provider about limits
- Use WP-CLI for very large exports
- Schedule the export during off-peak hours
File Won’t Open in Excel #
Problem: Excel shows garbled characters or import errors.
- Use Data → From Text/CSV instead of double-clicking
- Ensure UTF-8 encoding is selected
- Check that the file downloaded completely
- Try opening in Google Sheets first
- Re-export and download again
Missing Custom Fields #
Problem: Custom fields not appearing in export.
- Ensure “Include custom fields” is checked
- Verify custom fields exist and have data
- Check if custom fields are visible to your role
- Try exporting a single contact with custom fields
- Review custom field permissions
Empty Export File #
Problem: Export completes but the file has no data rows.
- Check if filters are too restrictive
- Verify contacts exist matching the criteria
- Try the “Export all contacts” option
- Check if you have permission to view contacts
- Review ownership filters (if applicable)
Special Characters Display Incorrectly #
Problem: Accented characters or symbols show as ?? or boxes.
- Ensure the file is UTF-8 encoded
- Use the proper import method in Excel (Data → From Text/CSV)
- Check if your spreadsheet application supports UTF-8
- Try opening in Google Sheets (better UTF-8 support)
- Re-export and ensure UTF-8 BOM is included
Best Practices #
Regular Backups #
- Schedule Weekly Exports: Export all contacts every week, include custom fields, store in multiple locations
- Before Major Changes: Export before bulk operations, plugin updates, or data migrations
- Retention Policy: Keep the last 4 weekly backups, monthly backups for 1 year, archive annually
Data Security #
- Secure Storage: Don’t store exports in public directories; use encrypted storage; limit access to authorized users
- Transmission: Use HTTPS for downloads; encrypt before emailing; use secure file sharing services
- Cleanup: Delete old exports after backup; don’t leave exports on the server indefinitely; clear your downloads folder regularly
File Management #
- Naming Convention:
contacts-export-YYYY-MM-DD.csv
contacts-newsletter-2026-02-03.csv
contacts-backup-weekly-2026-W05.csv
- Documentation: Note the export date and filters used, document the purpose of the export, track what was done with the data
- Version Control: Keep the original export, save edited versions separately, document changes made
Need Help? #
If you’re experiencing export issues:
- Try exporting a small filtered set first
- Check browser console for errors
- Verify you have export permissions
- Test with a different browser
- Contact support with error details
Last updated: February 3, 2026