Two ways to put a contact in a QR code
A contact QR code works one of two ways. The code can hold the whole contact card as text, which phones read offline. Or the code can hold a web address that opens a contact file hosted online. Our generator does the second: it encodes web addresses only and rejects text that starts with BEGIN:VCARD (we tested this on 19 November 2026). Here is what each approach means in practice.
What goes inside a vCard
vCard is the standard contact format. Version 3.0 (RFC 2426) requires three properties: VERSION, N (structured name) and FN (formatted name). Version 4.0 (RFC 6350) requires only VERSION and FN, and registers the file extensions .vcf and .vcard with the media type text/vcard. A typical card looks like this:
BEGIN:VCARD
VERSION:3.0
N:Silva;Ana;;;
FN:Ana Silva
ORG:Example Studio
TITLE:Designer
TEL;TYPE=CELL:+15551234567
EMAIL:ana@example.com
URL:https://example.com
END:VCARD- Write phone numbers in international format with the plus sign, so they dial correctly abroad.
ORG,TITLE,EMAIL,URLandADR(address) are optional. Each one you add makes an embedded code denser.- A photo can be embedded in a vCard file, but never inside a QR code. It is far too much data.
Embedded card or hosted file: the density trade-off
We encoded the card above with the same QR library our tool uses. At Medium error correction the 168-character card needs QR version 9, a grid of 53 x 53 modules. A link to a hosted file such as https://example.com/ana.vcf (27 characters) needs version 3, a grid of 29 x 29. Printed at the same size, the link version has modules almost twice as wide, so it scans faster and from further away.
The compact MECARD format, which the ZXing wiki says NTT DoCoMo popularised, sits in between. The same details as MECARD:N:Silva,Ana;TEL:...;EMAIL:...;URL:...;; took 83 characters and version 5. The ZXing project notes that vCard is "a bit verbose" for 2D barcodes.
The bigger difference is editing. An embedded card is frozen in the print. A hosted .vcf file can be replaced with a new file at the same address when your number or job title changes. The printed code stays the same, and the file behind it is new. The catch is that scanning then needs an internet connection, and the file must stay at that exact address.
Hosting the .vcf file so phones open it
Put the file on a site you control and serve it with the text/vcard media type that RFC 6350 registers. How a phone handles the file after opening it varies by phone and browser. Some show the contact with an add button, others download it first. Test on an iPhone and an Android phone before printing anything.
If you would rather send people to a contact page than a file, that works too, and it can hold more than a card can: a booking link, a portfolio, office hours. See the business card QR guide for sizing a code on a card.