Back to Resources
guides5 min read
CSV Variables for Mail Merge
Master CSV formatting and variable mapping for personalized emails.
CSV Formatting
Your CSV file should follow these guidelines:
- First row contains column headers (these become your variables)
- Use consistent data formats throughout
- Avoid special characters in headers
- UTF-8 encoding recommended
Example:
first_name,last_name,company,email
John,Smith,Acme Corp,john@acme.com
Jane,Doe,Tech Inc,jane@tech.com
Variable Mapping
Column headers automatically become variables:
first_name→{{first_name}}company→{{company}}
Tips:
- Use lowercase, underscore-separated names
- Be descriptive but concise
- Avoid spaces in header names
Common Issues
- Encoding problems - Ensure UTF-8 encoding
- Missing data - Set default values for empty cells
- Special characters - Escape quotes properly
- Large files - Outboxer handles large CSVs efficiently
The Local-Only Advantage
Frequently Asked Questions
Ready to Start
Download the free trial. Local-first mail merge.