OutboxerOutboxer
ProductUse CasesDownloadPricingSecurityResources
DE
DE
OutboxerOutboxer

Local-first desktop mail merge. Your data stays on your machine.

Product

  • Product
  • Download
  • Pricing
  • Security

Company

  • Use Cases
  • Resources
  • About
  • Contact

Legal

  • Legal Notice
  • Privacy Policy
  • Terms of Service

© 2026 Outboxer. All rights reserved.

Back to Resources
guides5 min read

CSV Variables for Mail Merge

Master CSV formatting and variable mapping for personalized emails.

Table of Contents

  1. 1. CSV Formatting
  2. 2. Variable Mapping
  3. 3. Common Issues

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

  1. Encoding problems - Ensure UTF-8 encoding
  2. Missing data - Set default values for empty cells
  3. Special characters - Escape quotes properly
  4. Large files - Outboxer handles large CSVs efficiently
The Local-Only Advantage

With Outboxer, all your data stays on your machine. No cloud uploads, no third-party servers — complete data control and GDPR compliance by design.

Frequently Asked Questions

Ready to Start

Download the free trial. Local-first mail merge.