vCard QR Code or .vcf File? What Each One Carries
A QR code gets bigger and harder to scan with every field you add. Here is what a vCard QR holds, what a file holds, and how to test a code before you print it.
You can give someone your contact details in two ways: a QR code they scan with their camera, or a .vcf file they open and import. Both hold a vCard, which is plain contact text, so it is easy to assume they hold the same thing. They don't. A QR code has a fixed amount of room, and every field you add makes the code denser. A file has no such symbol to fill.
Want to see the difference on your own details? Clear vCard builds the card, the QR code and the .vcf in your browser, and nothing is uploaded.
What Each One Carries
| QR code | .vcf file | |
|---|---|---|
| Contents in Clear vCard | The vCard text: name, title, company, phone, email and website. No photo and no social links. | The same card, plus a photo and your social links if you added them. |
| How the other person gets it | Point a camera at it, then follow the prompt to add the contact. | Receive the file, open it and import it. |
| Room available | Fixed by the symbol. Version 40 is the largest, at 2,953 bytes of binary data. | Not limited by a symbol size. |
| Best when | The person is in front of you, or the code is printed on something. | The card has to travel by email or message, or must include a photo. |
Why More Fields Mean a Harder Scan
Denso Wave, the company behind the QR code, describes versions 1 to 40, from 21 × 21 modules up to 177 × 177, growing by 4 modules per side, with more data giving a larger symbol. A bigger symbol printed at the same width means smaller squares, and small squares are harder for a camera to read.
To see how much a vCard adds, I generated codes from sample text with an open-source Python library. Another generator may choose different versions, so read these as a pattern, not a rule.
| Text encoded | Size | Lowest correction level | Highest correction level |
|---|---|---|---|
| A 23-character web address | 23 bytes | Version 2 (25 × 25) | Version 3 (29 × 29) |
| A short vCard: name, company, title, phone, email, website | 171 bytes | Version 8 (49 × 49) | Version 13 (69 × 69) |
| The same fields with long values and a tracking link | 324 bytes | Version 12 (65 × 65) | Version 19 (93 × 93) |
The same person's details can be a 25 × 25 grid as a link or a 93 × 93 grid as a full card. The more the code says, the closer the phone has to be to read it.
One vendor article on MeCard, a shorter contact format, makes the same point: it calls vCard larger and prone to QR errors, and MeCard compact. If your code is dense, try trimming the longest fields first. For the capacity limits themselves, see QR Code Character Limit.
A Scan Checklist Before You Print
- Print it at the real size and scan the paper, not the screen. QRStuff suggests at least 2 cm × 2 cm for a code scanned by hand.
- Keep the blank margin around the code. Denso Wave notes that a margin is required.
- Scan with two different phones and from a normal reading distance.
- Open the result and confirm every field: name, phone number, email and website.
- Re-make the code if anything changes. The details are part of the code itself, so a new phone number means a new code.
Using Both
A practical split is the QR code for the people you meet, and the .vcf for anyone who needs your photo or social links or wants a file in an email. If you receive a file, How to Import a .vcf Contact File on iPhone, Android and Outlook covers the steps, and What Is a vCard and Why Is It Still Useful? explains the format.
The honest summary: a QR code and a .vcf file carry the same kind of text, but the code has a size ceiling and gets harder to scan with every field, while the file can also include a photo and social links. Keep the code to the fields people need, print it at the real size and scan it on two phones before you trust it.
For questions or inquiries contact us at info@cleartexteditor.com