Glossary Term

vCard QR Code

glossary vcard qr code featured

A vCard QR code is a QR code that stores a contact record in the vCard format, so a phone can save the name, number, and email as a new contact after one scan. The contact data sits inside the code itself, with no link or server involved. It is the most common type of contact QR code, used on business cards, badges, and email signatures.

What a vCard QR Code Contains

A vCard QR code contains plain text in the vCard format, the same format as a .vcf contact file. The scanner reads the text, recognizes the BEGIN:VCARD header, and offers to save the contact instead of opening a web page.

A minimal vCard 3.0 payload looks like this:

BEGIN:VCARD
VERSION:3.0
N:Rivera;Maya;;;
FN:Maya Rivera
TEL;TYPE=CELL:+1-415-555-0142
EMAIL:maya.rivera@northwind-studio.com
END:VCARD

Each line is one property. FN is the display name, and N is the structured name (last name first). The current standard is vCard 4.0, published by the IETF as RFC 6350 in August 2011. Many QR generators still write version 3.0 (RFC 2426, September 1998), which contact apps have supported for decades.

vCard vs MeCard

MeCard is a shorter contact format created by NTT Docomo for Japanese mobile phones. It fits the same fields on one line:

MECARD:N:Rivera,Maya;TEL:+14155550142;EMAIL:maya.rivera@northwind-studio.com;;

MeCard saves about 30% of the characters, but it has no RFC or ISO standard, and it supports fewer fields. vCard is the safer default. Use MeCard only when a long contact record will not fit at the print size you need.

How Each Field Changes the Code

Every field you add makes a vCard QR code denser, and denser codes scan from a shorter distance. vCard text is long, so contact codes get large faster than URL codes.

A reproducible test built the same contact field by field and printed each code 2 cm wide. The simulated phone camera ran 40 scans per setting (zxing-cpp 3.1.1, Segno 1.6.6):

Payload Bytes QR version (level M / H) Max scan distance at 2 cm (M / H)
Name only 69 5 / 8 20 cm / 18 cm
Name, phone, email 140 8 / 12 18 cm / 14 cm
+ company, title, website 224 11 / 16 14 cm / 12 cm
+ postal address and note 354 14 / 20 12 cm / 10 cm
Short URL to a contact page 21 2 / 3 30+ cm / 24 cm

Max distance is the farthest point with at least 38 of 40 successful reads. A higher QR code version packs more modules into the same 2 cm, so each module shrinks. A full nine-field card at level H read only within 10 cm. Keep a vCard to the three or four fields people actually use.

vCard QR Code vs Digital Business Card QR Code

A vCard QR code carries the contact itself. A digital business card QR code carries a short link to a hosted profile page, which shows contact details and usually a “save contact” button.

  • vCard QR code: works offline, needs no server, and never expires. It cannot be edited after printing and cannot count scans.
  • Digital business card QR code: editable after printing, trackable, and can hold a photo, social links, and a calendar link. It needs an internet connection and a live page.

The link version also produces a much simpler code. In the test, a 21-character short URL needed Version 2, while a basic three-field vCard needed Version 8.

Common vCard QR Code Issues

  • Photos rarely fit. A 48 x 48 pixel JPEG of under 1 KB became 1,324 base64 characters and pushed the code to Version 32. That is too dense to print on a card.
  • Accented names in vCard 3.0. Version 3.0 has no built-in character set, so some older readers garble names like “Zoë Núñez”. vCard 4.0 requires UTF-8, which removes the ambiguity.
  • Phone numbers without a country code. Write +1-415-555-0142, not (415) 555-0142, so the number dials correctly abroad.
  • Missing required fields. Both versions require the FN property, and version 3.0 also requires N. Leave either out and some contact apps may not import the card cleanly.

Frequently Asked Questions

What is a vCard?

A vCard is a standard file format for electronic business cards. vCard files use the .vcf extension, short for Virtual Contact File. The Versit Consortium created the format, and the IETF standardized versions 3.0 and 4.0 as RFCs. Rights to the format passed to CalConnect in 2004.

Can a vCard QR code include a photo?

Technically yes, but in practice no. vCard allows a base64-encoded photo, and even a tiny 48-pixel thumbnail adds more than 1,300 characters. The resulting code is too dense to scan at business card size. Use a digital business card link instead if a photo matters.

Should a vCard QR code use version 3.0 or 4.0?

Use vCard 3.0 unless names contain accented or non-Latin characters. Version 3.0 is the older, long-supported version, and many generators still produce it. Version 4.0 mandates UTF-8, which makes it the cleaner choice for international names. Scan-test either version on an iPhone and an Android phone before printing.

Is a contact QR code static or dynamic?

A vCard QR code is always static, because the contact data is written into the pattern. A new phone number means a new code. A dynamic contact QR code encodes a short redirect link to a contact page instead. That page can be updated, and scans can be counted.

To create one, use the free vCard QR code generator and test the printed card on two phones.

Back to Glossary