VCF to CSV converter with editable field mapping

Convert local contact files between VCF and CSV with editable mapping. Your file stays in your browser.

Your contact file

Convert

Up to 2 MB and 2,000 contacts.

Map the fields

Repeated values

Empty uses matching field names. Map source names to output names.

2 contacts converted

Review the mapped values and field-loss report before importing.

Mapped contact preview

Field-loss and duplicate report

Converted file

Map the contact fields

This VCF to CSV converter turns local vCard contacts into editable column mappings. Choose CSV to VCF to create a vCard file from contact rows.

The parser reads vCard 3.0 and 4.0 contact blocks. It supports display names, structured names and organisation text, plus repeated email addresses and telephone numbers.

Display name is the formatted FN value. The N value separates family and given names, additional names, prefixes and suffixes. The organisation comes from ORG.

Use detected mapping to fill the JSON object, then edit its values. For VCF to CSV, {"displayName":"Contact","phone1":"Mobile"} creates those two output columns. Other nonempty fields appear in the omission report.

For CSV to vCard conversion, {"Person":"displayName","Mobile":"phone1"} maps your existing CSV headers to contact fields. Use displayName, family, given, additional, prefix, suffix and organisation for single values.

Numbered values use email1 and phone1, then email2 and phone2 as needed. Add email1Label or phone1Label for TYPE labels such as work, home or cell. Numbered fields support indices 1 to 99.

Telephone numbers remain text identifiers. The examples retain 0412345678, 0012345 and +61255500101. Import these columns as text in a spreadsheet to preserve their zeros and plus signs.

Keep repeated values visible

Separate columns keeps each email address or telephone number beside its own label column. JSON lists puts every value and label in one emails or phones cell.

A JSON list cell contains objects such as [{"value":"0412345678","label":"cell"}]. CSV quotes the JSON text. CSV input accepts either these lists or numbered fields, without mixing the two layouts.

The CSV to VCF converter writes UTF-8 vCard 4.0, with a separate EMAIL or TEL property for each value. Folded lines follow the byte limits in the vCard format specification.

Photographs, addresses, notes and custom properties appear in the field-loss report. They are omitted from the download. Unsupported parameters, including preference settings, are also reported.

Repeated FN, N or ORG properties keep their first value and report later values. Multiple organisation units become one text value. Name-component lists become comma-separated text, with a warning.

vCard 2.1 and encoded name or contact properties require a UTF-8 re-export. The parser stops on quoted-printable and property-specific character sets. vCard 4.0 files require UTF-8.

Choose an encoding only when reading file bytes. Pasted text is already decoded. The original file stays unchanged, and contact text clears when you leave this page.

Review before importing

The fictional example contains Zoë, Example and René Sample. Zoë has two telephone numbers and two email addresses. The comma in Zoë’s name stays inside one quoted CSV cell.

Switch to CSV to VCF to load the other fictional example. It converts two contact rows into separate vCard blocks. Switching direction replaces the input with that direction’s example.

The preview shows every mapped source contact. The report identifies unsupported properties and omitted columns. Exact duplicate parsed contacts stay in the output and receive their contact numbers in the report.

The duplicate check compares complete parsed records, including label order and letter case. It cannot establish whether different records describe the same person. Review matching emails or numbers yourself.

Empty names remain visible in CSV output. A CSV-to-VCF download requires a display name on every row. Missing names stop the export and identify the source row.

CSV quoting follows the common CSV format. Quoting preserves commas and line breaks but does not stop a spreadsheet interpreting formula-like text. Import contact columns as text.

Open the converted file in your receiving application’s import preview. Compare all contact values before saving. This tool exports files locally and does not connect to a customer relationship management system or grant permission to contact anyone.