How to open a VCF file

Opening a .vcf and reading a .vcf are two different jobs, and most instructions answer the first one while you were asking the second.

Double-click the file and your computer does not show it to you — it absorbs it. Every record lands in your address book at once, shuffled in among the people already there, with no look-first step in front of the decision. For a single business card that is fine. For four hundred entries exported off somebody else’s handset it is a merge you never agreed to, and undoing it costs an afternoon.

So if the question is who is in this thing, look before committing. That is what the VCF file viewer is for: it lists the records on screen and writes to nothing.

What is a vCard file?

Ordinary text, saved with a .vcf ending. One person per block, one field per line, and any text editor will show you the raw contents. Here is a complete record:

BEGIN:VCARD
VERSION:3.0
N:Okafor;Ada;;;
FN:Ada Okafor
ORG:Northwind Design
TEL;TYPE=CELL:+1-415-555-0142
EMAIL;TYPE=WORK:ada@example.com
ADR;TYPE=HOME:;;1200 Bay Street;San Francisco;CA;94133;USA
BDAY:1988-03-14
END:VCARD

Two lines there explain most of what happens later. N holds five values split by semicolons — family name, given name, middle names, an honorific prefix, a suffix such as Jr — while FN carries the same person pre-assembled for display. ADR holds seven, running from a post office box, past the street line, to the country; the empty slots at the front are positions, not padding. A file may hold one block or several thousand.

How can I open a vCard file?

Every platform will take the file. What differs is whether you get to see anything before it commits.

macOS. Double-clicking hands the file to Contacts, which puts up a confirmation saying how many cards it is about to add. Selecting the file in Finder and pressing the space bar previews it without importing anything.

Windows. The file goes to whichever contacts program is registered for it, and the built-in handling is arranged around one card at a time. It has a long-standing reputation for taking only the first record out of a file holding many, so count what arrives against what you expected instead of assuming the import finished.

iPhone and iPad. Tapping the attachment shows the card and offers to create a new contact or merge it into an existing one. A file with many records offers to add all of them in a single action — all or nothing, with no way to pick.

Android. The file opens in the contacts app, which asks which account to save into before importing. That question matters: choose the Google account and the records sync out to every device signed in to it.

Gmail and Google Contacts. Downloading the file accomplishes nothing by itself, since nothing in the browser reacts to it. Google Contacts has its own import command, and you hand the file over there. It is also the one route on this list that is genuinely reversible: everything from a single import gets tagged with a dated label, so selecting that label and deleting the batch undoes a wrong file cleanly.

Outlook. The classic desktop program opens a vCard as a single contact form that you then save, one record at a time. Its import wizard is built around spreadsheets rather than contact files, which is why a large .vcf is usually routed through a CSV first.

Why the names arrive looking like =C3=A9

A file full of Jos=C3=A9 Garc=C3=ADa is not damaged, and it is the most common reason an imported phonebook looks wrecked. The 1996 edition keeps its lines inside plain ASCII, so anything outside that range gets spelled out in hexadecimal. In UTF-8 the letter é is the byte pair C3 A9 — and the pair is exactly what you are looking at. Long values are chopped the same way, ending on = and continuing underneath.

A second trap sits behind it. Which character set those bytes belong to is declared line by line, so one file can legally hold a record in Latin-1 and the next in Unicode. Software that picks a single answer for the whole document corrupts whichever half disagreed — which is how a file gets blamed for damage the reader caused. Handle each line on its own terms and the accents come back as typed, which is what you see if you drop the file into the viewer.

Three versions, and the line that tells you which

VERSION sits inside each record, just after BEGIN:VCARD, and it is worth reading rather than guessing.

• 2.1, from 1996, is the one that uses the hexadecimal escaping above. Old handset exports and some mail clients still emit it.
• 3.0, RFC 2426 from 1998, is what most exports look like today, including the example further up.
• 4.0, RFC 6350 from 2011, tightened the rules and allows only UTF-8.

They disagree about smaller things too — how a phone number gets labeled, how a photograph is attached — so a merged export from two handsets can legitimately carry several versions at once, and a program that reads one edition well may still mangle the next.

How do I create a VCF file?

Not here. This site has no tool that writes one, and no plan for a spreadsheet-to-vCard page either, for a blunt reason: Google Contacts does that conversion free. Import your sheet there, export the result as a vCard, done.

Otherwise the file comes out of whatever already holds the contacts. Every address book — phone, Mail, Outlook, Google — has an export command, and export is the step that writes .vcf. A single card can be typed by hand: copy the block above into a text editor, change the values, save with a .vcf ending.

How to retrieve contacts from a VCF file

If retrieving means rows you can sort, deduplicate or feed into something expecting a table, that is VCF to CSV. Since the format keeps names and street addresses in separate slots to begin with, a table is closer to the file’s own shape than the tidy single line an address book shows you. The CSV viewer opens the finished table with no spreadsheet program installed, and what a CSV file is explains the encoding choices you will be asked to make.

One last thing about the contents

A contact export is other people’s information: their mobile numbers, their home addresses, the birthdays they told you once. Reading it requires handing it to nobody. Both pages linked here work inside your own browser — check that for yourself in a minute with the network panel open.