All articles

What Is a vCard File and How Do I Open One?

A vCard (.vcf) is a standard text file of contact details. Open it in your Contacts app: tap it on a phone, double-click it on a Mac, or import it.

Cover reading What Is a vCard File and How Do I Open One? on a dark background

A vCard file is a small text file, usually ending in .vcf, that holds someone’s contact details in a standard format every Contacts app understands. To open one, hand it to your Contacts app: tap it on a phone, double-click it on a Mac, or use the Import option on iCloud.com or in Outlook. The contact gets added with every field in place, so nobody retypes anything.

What’s inside a vCard

vCard is defined by the IETF in RFC 6350, which describes it as a format “for representing and exchanging a variety of information about individuals and other entities.” That covers names, postal addresses, email, several phone numbers, and even a photo or logo.

Under the hood it’s just labeled lines of text. A very small one looks like this:

BEGIN:VCARD
VERSION:4.0
FN:Priya Shah
EMAIL:priya@example.com
END:VCARD

The spec’s rules are strict on a few points. Every card starts with BEGIN:VCARD and ends with END:VCARD, the VERSION line comes right after the start, and a formatted name (FN) has to be there. Everything else is optional.

The format is older than smartphones. The vCard article on Wikipedia traces it to the Versit Consortium, with rights passing to the Internet Mail Consortium in 1996 and to CalConnect in 2004. Three versions are still around:

Version Defined in Where you’ll see it
2.1 Versit specification, 1996 Older phones and some exports
3.0 RFC 2426 Very common in apps and card services
4.0 RFC 6350 The current standard

You’ll mostly see the .vcf extension, sometimes .vcard. The version usually doesn’t matter to you as a reader. It matters when a field shows up in one app and vanishes in another.

How to open a vCard file

On iPhone or Android

Tap the file wherever it arrived: an email attachment, a chat message, a download from a web page. The phone hands it to the Contacts app, which shows a preview with a button to create a new contact or add to an existing one. Check the name and number, then save.

This is also what happens when you tap Save Contact on a digital business card. The page downloads a vCard and your phone opens it.

On a Mac

Apple’s Contacts guide for Mac gives three ways in:

  1. Double-click the vCard file.
  2. Drag it onto the Contacts icon.
  3. Or open Contacts, choose File > Import, and pick the file.

Then click Add in the dialog that appears. Contacts flags duplicates so you can review them before they pile up. One thing to know: “Custom fields aren’t imported.”

On iCloud.com

Handy when you’re on a Windows PC and want the contact on your iPhone. Per Apple’s iCloud instructions, go to icloud.com/contacts, click the Add button, choose Import Contact, and select the vCard. If the file has several people in it, each one becomes its own entry, and it syncs down to your devices.

In Outlook

Outlook is the awkward one. For a vCard attached to an email, Microsoft’s instructions are to right-click the card in the message body, click Add to Outlook Contacts, then Save & Close, and repeat for each card. Microsoft is blunt that you “add each vCard one-by-one.”

A bulk file is harder. For a full export from iCloud, Microsoft says that on a PC “you need to convert them from a .vcf file format to a .csv file format” before Outlook will take them, and that with “more than 50 or so contacts, this is a tedious process because you have to press OK for each contact.” If you’re moving a whole address book, skip that and import it on iCloud.com, which turns a multi-person file into separate entries in one go.

In a text editor

Since it’s plain text (the media type is text/vcard), Notepad or TextEdit opens it fine. Embedded photos come out as a long block of characters rather than an image. This is the quickest way to see what a file contains before you import it, or to work out why a field went missing.

A real example

You’re at a trade show and a supplier emails you a file called contact.vcf after a chat at their booth. On your phone, you tap it, check that the name came through as first and last rather than one long string, and tap Create New Contact. Done.

Back at your desk, you want the same contact in Outlook. You right-click the attachment, choose Add to Outlook Contacts, save. Had the supplier sent their whole sales team in one file, Outlook would want them one by one.

What goes wrong

Only one contact imports. Before blaming the app, check the file. Microsoft says “the most common mistake we see customers make is they export only 1 contact from iCloud when they intended to export all of them.” Open the file in a text editor and count the BEGIN:VCARD lines.

Fields disappear. A field one app writes may not be one the next app reads. Custom fields are the usual casualty, and Apple says outright that Contacts on Mac doesn’t import them.

Duplicates. Importing the same file twice gives you two of everyone. On a Mac, review the duplicates Contacts flags before you click through.

The file opens as text. If double-clicking shows a wall of TEL: and EMAIL: lines, your computer has a text editor set as the default app for .vcf. Use the Import option in your Contacts app instead, or change the default.

My take

The vCard is the most underrated part of a digital business card. People talk about QR codes and NFC, but those are only the delivery. What saves time is that the other person ends up with a proper contact entry, name in the name field and number in the number field, instead of a screenshot they’ll never look at again. A card tool that can’t produce a clean vCard isn’t worth using.

How QRCard handles this

When someone taps Save Contact on a QRCard profile, QRCard generates a standard vCard 3.0 file that opens straight in the iPhone or Android Contacts app. The person viewing your card needs no app, just a browser.

The limitation: a vCard is a snapshot. Your link and QR code always show your current details, but a contact someone saved last year keeps last year’s number until they save you again.

If you want to decide what goes into that file, start with what to put on a digital business card. To get the vCard to people in person, see how to make a QR code for your business card or the NFC business card guide. And if you’re on iPhone and want your card one tap away, read how to add a digital business card to Apple Wallet.

FAQ

Is a .vcf file safe to open?

A vCard is a text file of contact details, not a program, so opening it in your Contacts app adds a contact rather than running anything. Still treat files from strangers with the same care as any attachment, and check the details before you save them.

Can one vCard file hold more than one contact?

Yes. Exports from Contacts apps often put every contact into a single .vcf. On iCloud.com, Apple says each person in a multi-contact vCard becomes a separate entry when you import it.

Why won’t Outlook import my whole .vcf file?

Outlook adds vCards from emails one at a time. For a bulk file on a PC, Microsoft’s own instructions say to convert the .vcf to a .csv first and import that.

Can I open a vCard file without a Contacts app?

Yes. It is plain text, so any text editor shows the fields line by line. You can read it that way, but to use it as a contact you need to import it into a Contacts app.

Sources