Sample VCF File Download

VCF (Virtual Contact File) is the definitive format for contact information exchange. Whether you are building a new CRM, testing mobile contact syncing, or performing a mass data migration, our vCard samples provide the structured data you need to ensure success.

Technical Implementation & Best Practices

While there are several versions of the vCard specification (2.1, 3.0, and 4.0), our samples prioritize vCard 3.0. This version strikes the perfect balance between modern features (like social profile support) and total backwards compatibility with legacy enterprise systems like older versions of Microsoft Outlook.

• Cross-Platform Ready: Fully compatible with iPhone (iOS), Android Contacts, macOS Address Book, and Windows People app.
• Structured Formatting: Adheres to the field-colon structure required by strict parsers, including proper namespacing for international characters.
• Data Richness: Includes not just names and numbers, but job roles, organizations, URLs, and custom notes.

Explore the full technical documentation at the IETF vCard 3.0 RFC or the newer vCard 4.0 Specification .

VCF files are used in contact management systems, CRM import pipelines, mobile device synchronization, and QR code generators. The examples below show how to parse, read, and import VCF contact data in code.

How to Parse a VCF File in Python (vobject)

The vobject library is the standard Python tool for reading and writing vCard files. It parses each contact as a component with named properties accessible as attributes.

import vobject

with open("sample-contacts.vcf", "r", encoding="utf-8") as f:
    vcf_data = f.read()

for vcard in vobject.readComponents(vcf_data):
    name = vcard.fn.value  # Formatted name
    if hasattr(vcard, "email"):
        email = vcard.email.value
    if hasattr(vcard, "tel"):
        phone = vcard.tel.value
    print(f"{name}: {email} / {phone}")

How to Import a VCF File into Google Contacts

Go to contacts.google.com, click the Fix & manage menu in the left sidebar, then choose Import. Click Select file, choose your downloaded .vcf file, and click Import. Google Contacts will parse each BEGIN:VCARD...END:VCARD block as a separate contact. Multi-contact VCF files are fully supported.

How to Import a VCF File into Apple Contacts (Mac/iPhone)

On Mac, double-click the .vcf file and Contacts app opens automatically and asks whether to add the contact(s). Click Add All for multi-contact files. On iPhone, open Files, tap the VCF file, and it immediately prompts you to add the contact to your address book. No additional apps needed.

How to Read VCF Properties in JavaScript (Node.js)

The vcf npm package parses vCard files into structured JavaScript objects. Each property becomes an array item with a value and optional parameters.

const vCard = require("vcf");
const fs = require("fs");

const raw = fs.readFileSync("sample-contacts.vcf", "utf8");
const cards = vCard.parse(raw);

cards.forEach((card) => {
  const name = card.get("fn")?.valueOf();
  const email = card.get("email")?.valueOf();
  const tel = card.get("tel")?.valueOf();
  console.log(name + " | " + email + " | " + tel);
});

A VCF file is a plain text file where each contact is wrapped in a BEGIN:VCARD and END:VCARD block. Properties are written as PROPERTY:value or PROPERTY;param=value:value pairs, one per line.

Creating a VCF File Manually in a Text Editor

A minimal valid vCard 3.0 contact requires only the BEGIN, END, VERSION, and FN (formatted full name) properties. All other fields are optional. Multiple contacts can be stored in one .vcf file by placing multiple BEGIN:VCARD...END:VCARD blocks in sequence.

BEGIN:VCARD
VERSION:3.0
FN:Alice Johnson
N:Johnson;Alice;;;
EMAIL;type=INTERNET;type=WORK:alice@example.com
TEL;type=CELL:+1-555-0101
ORG:Acme Corporation
TITLE:Software Engineer
ADR;type=WORK:;;123 Main St;Springfield;IL;62701;USA
END:VCARD

BEGIN:VCARD
VERSION:3.0
FN:Bob Smith
N:Smith;Bob;;;
EMAIL;type=INTERNET;type=WORK:bob@example.com
TEL;type=CELL:+1-555-0102
END:VCARD

Generating a VCF File in Python (vobject)

import vobject

contacts = [
    {"name": "Alice Johnson", "email": "alice@example.com", "phone": "+1-555-0101"},
    {"name": "Bob Smith", "email": "bob@example.com", "phone": "+1-555-0102"},
]

vcards = []
for c in contacts:
    vcard = vobject.vCard()
    vcard.add("fn").value = c["name"]
    vcard.add("email").value = c["email"]
    vcard.add("tel").value = c["phone"]
    vcards.append(vcard.serialize())

with open("output.vcf", "w", encoding="utf-8") as f:
    f.write("".join(vcards))

print("VCF file created successfully.")

Common mistakes to avoid: The VERSION property must come immediately after BEGIN:VCARD — placing it elsewhere breaks some parsers. Never split a property across multiple lines without using the vCard line-folding convention (indent the continuation with a single space). Always use UTF-8 encoding to handle international characters in names and addresses correctly.