vCard Format Explained: Everything You Need to Know
The vCard format is the universal standard for exchanging contact information electronically. If you have ever saved a contact from an email attachment or scanned a QR code to add someone to your phone, you have used a vCard. The file extension is .vcf (Virtual Contact File), and the format is supported by every major operating system, email client, and contacts application.
Despite being one of the most widely supported file formats in computing, most people have never looked inside a vCard file. Understanding the format helps you make better decisions about how you create and share your digital business cards.
A Brief History
The vCard specification was originally created by the Versit Consortium in 1995, a joint effort by Apple, AT&T, IBM, and Siemens. The Internet Engineering Task Force (IETF) later took over stewardship and published the format as a series of RFCs:
- vCard 2.1 — The original version, still occasionally encountered in older systems.
- vCard 3.0 — Defined in RFC 2426, this version standardized the format and is the most widely supported version in practice. It is the version used by tools like Virtual Contact Cards.
- vCard 4.0 — Defined in RFC 6350, this version added features like support for multiple languages and more flexible data types. Adoption is growing but not yet universal.
For practical purposes, vCard 3.0 remains the safest choice for maximum compatibility. It works everywhere — iPhones, Android phones, Outlook, Google Contacts, and virtually every CRM system.
What Does a vCard File Look Like?
A vCard is a plain text file with a specific structure. Here is a minimal example:
BEGIN:VCARD
VERSION:3.0
FN:Jane Smith
N:Smith;Jane;;;
ORG:Acme Corp
TITLE:Product Manager
TEL;TYPE=WORK,VOICE:+1-555-123-4567
EMAIL;TYPE=WORK:jane.smith@acme.com
URL:https://janesmith.com
END:VCARD
Each line is a property that describes one piece of contact information. The file starts with BEGIN:VCARD and ends with END:VCARD. The VERSION property declares which version of the spec the file follows.
Because vCards are plain text, they are small (typically under 1 KB without a photo), easy to transmit, and readable by both humans and machines.
Key vCard Properties
Here are the most commonly used properties in a vCard 3.0 file:
Identity
- FN (Formatted Name): The contact's display name as it should appear, e.g.,
FN:Jane Smith. - N (Name): A structured breakdown of the name into components: last name, first name, middle name, prefix, and suffix, separated by semicolons. Example:
N:Smith;Jane;;Dr.;.
Organization
- ORG: The company or organization name. Example:
ORG:Acme Corp. - TITLE: The job title. Example:
TITLE:Product Manager.
Communication
- TEL: A phone number. The
TYPEparameter specifies the kind of number. Examples:TEL;TYPE=WORK,VOICE:+1-555-123-4567orTEL;TYPE=CELL:+1-555-987-6543. - EMAIL: An email address, with an optional
TYPEparameter. Example:EMAIL;TYPE=WORK:jane@acme.com.
Location
- ADR: A structured address with components for PO box, extended address, street, city, region, postal code, and country, separated by semicolons. Example:
ADR;TYPE=WORK:;;123 Main St;Springfield;IL;62701;USA.
Online
- URL: A website address. Example:
URL:https://janesmith.com.
Photo
- PHOTO: An embedded image, typically Base64-encoded. This is what allows your contact photo to appear when someone saves your vCard. The property can make vCard files significantly larger — a small profile photo can add 10-50 KB to the file size.
Notes
- NOTE: A free-text field for any additional information. Example:
NOTE:Met at the 2025 SaaS conference.
How Devices Handle vCard Files
When a device receives a .vcf file, the behavior is consistent across platforms:
- iOS (iPhone/iPad): Opening a
.vcffile launches the Contacts app and displays an "Add Contact" or "Add to Existing Contact" prompt with all fields pre-populated. - Android: The behavior is identical — the Contacts app opens with a pre-filled contact form.
- Outlook: Double-clicking a
.vcffile opens the contact editor with all properties mapped to the appropriate Outlook fields. - Google Contacts: You can import
.vcffiles through the web interface or by opening them on an Android device.
The universal support is what makes the vCard format so practical. There is no app to install, no platform dependency, and no file conversion needed.
Common Pitfalls
Despite its simplicity, there are a few things to be aware of:
Character Encoding
vCard 3.0 uses UTF-8 encoding by default, but some older systems may expect different encodings. Stick with standard ASCII characters in phone numbers and use UTF-8 for names with accented characters or non-Latin scripts.
Photo Size
Embedding a high-resolution photo will bloat the file size. For digital business cards, a photo resized to around 200x200 pixels is sufficient and keeps the file compact.
Line Folding
The vCard spec requires that long lines be "folded" — split across multiple lines with a leading space on continuation lines. Most parsers handle this automatically, but it is worth knowing if you are editing vCard files by hand.
Special Characters
Semicolons and commas have special meaning in vCard properties. If your data contains these characters (for example, a company name like "Smith, Jones & Associates"), they need to be escaped with a backslash.
Creating vCard Files
You do not need to write vCard files by hand. Tools like Virtual Contact Cards handle the formatting, encoding, and edge cases for you. Enter your details, and the tool generates a standards-compliant .vcf file ready to share.
The tool creates vCard 3.0 files for maximum compatibility, supports profile photos, and runs entirely in your browser — your data never leaves your device.
Create your vCard now — it takes less than a minute.