CSV to vCard Converter
Paste a CSV or JSON contact list and generate one standards-friendly .vcf file for bulk import into iPhone, Android, Google Contacts, Outlook, or your CRM. Runs locally in your browser.
What this tool does
Turn a spreadsheet or exported contact list into a single .vcf vCard file you can import into iPhone Contacts, Android Contacts, Google Contacts, Outlook, Apple Contacts, or many CRM tools.
Paste either:
First Name,Last Name,Email,Mobile Phone,Company
John,Doe,[email protected],555-1234,Acme
or a JSON array of contact objects. The converter maps common headers to vCard fields automatically:
- name parts (
First Name,Last Name,Full Name) →NandFN - email columns →
EMAIL, with home/work type qualifiers when the header says so - phone, mobile, cell, fax →
TEL, withCELL,HOME,WORK, orFAX - company, department, job title →
ORGandTITLE - street, city, state, zip, country →
ADR - website, birthday, note, gender →
URL,BDAY,NOTE,GENDER(gender is vCard 4.0 only)
Everything runs locally in your browser. No contact data is uploaded.
Worked example
Input:
First Name,Last Name,Email,Mobile Phone,Company
John,Doe,[email protected],555-1234,Acme
Output:
BEGIN:VCARD
VERSION:3.0
N:Doe;John;;;
FN:John Doe
ORG:Acme
EMAIL:[email protected]
TEL;TYPE=CELL:555-1234
END:VCARD
Save the result as contacts.vcf, then import it in your contacts app.
Options
- Input format —
autotreats input starting with{or[as JSON and everything else as CSV. You can forcecsvorjson. - CSV delimiter —
autosniffs comma, semicolon, tab, or pipe from the header row. You can force one when the CSV is ambiguous. - vCard version —
3.0is the safest default for broad import compatibility.4.0emits vCard 4.0 syntax and includesGENDERwhen present.
Limits and edge cases
- The input must have recognizable headers such as
Name,First Name,Email,Phone,Company, or address fields. - Up to 5,000 contacts are converted in one run.
- Photos and binary attachments are not embedded. This is for text contact fields.
- Long vCard lines are folded at 75 octets for importer compatibility.
- Unknown columns are ignored rather than copied into custom properties.
- The converter escapes commas, semicolons, backslashes, and newlines in vCard values.
FAQ
Can I import the output into Google Contacts or Outlook?
Yes. Choose the default vCard 3.0 output for the broadest compatibility, save the result as contacts.vcf, then use the import feature in Google Contacts, Outlook, Apple Contacts, iPhone, or Android.
What column names does it recognize?
It recognizes common exports from spreadsheets, CRMs, and address books: Name, First Name, Last Name, Email, Work Email, Phone, Mobile Phone, Company, Department, Job Title, Street, City, State, Zip, Country, Website, Birthday, Notes, and similar variants.
Should I use vCard 3.0 or 4.0?
Use 3.0 unless you know the importer supports vCard 4.0. Version 3.0 is widely accepted by older contact apps. Version 4.0 is more modern and includes GENDER, but some importers are stricter about it.
Does the tool upload my contacts?
No. The conversion runs in WebAssembly in your browser, so the pasted contacts stay on your device. If you use the CLI, it runs locally there as well.
Developer & Automation Access
Run it from the terminal
Same engine as this page, headless — via the gizza CLI:
gizza tool csv-to-vcard "First Name,Last Name,Email,Mobile Phone,Company
John,Doe,[email protected],555-1234,Acme"New to the CLI? Get gizza →
Open it by URL
Pre-fill and auto-run this tool with query parameters — the names match the API/CLI:
https://gizza.ai/tools/csv-to-vcard/?data=First%20Name%2CLast%20Name%2CEmail%2CMobile%20Phone%2CCompany%0AJohn%2CDoe%2Cjohn%40example.com%2C555-1234%2CAcme&input_format=auto&delimiter=auto&version=3.0Machine-readable descriptor: tool.json — title + parameters JSON Schema for agents.
