Skip to content
Fundamentals

How to Create a QR Code for Your Contact Details (vCard QR Guide)

Codexengr, QR Systems Engineer
Published 2027-02-18 (Updated 2026-10-05)
4 min read
Peer Reviewed & Fact Checked

What Is a vCard QR Code?

A vCard QR code encodes your contact information in a standardised format (vCard). When scanned, the phone recognises it as a contact record and prompts the user to save it to their Contacts app — no typing required.

The vCard 3.0 Format (Most Compatible)

``` BEGIN:VCARD VERSION:3.0 N:Rahman;Alex;;; FN:Alex Rahman ORG:Acme Digital Ltd TITLE:Head of Marketing TEL;TYPE=CELL:+447911123456 TEL;TYPE=WORK:+442071234567 EMAIL:alex@acmedigital.com URL:https://acmedigital.com ADR;TYPE=WORK:;;123 High Street;London;;EC1A 1BB;UK END:VCARD ```

Key Fields Explained

- N: Name components in order: Last;First;Middle;Prefix;Suffix - FN: Full display name (what appears in the Contacts app) - ORG: Organisation name - TITLE: Job title - TEL: Phone numbers — specify type (CELL, WORK, HOME) for correct categorisation - EMAIL: Email address(es) - URL: Website - ADR: Address — use semicolons to separate PO Box; Extended; Street; City; Region; Postcode; Country

Keep It Short for Smaller QR Codes

Every character in the vCard increases the QR code version (size and density). For a business card QR: - Include: Name, one mobile number, one email, website - Omit: Full address, multiple phone numbers, notes - Consider: Linking to a redirect URL that serves the vCard download instead — this keeps the QR simple and lets you update contact details without reprinting

Testing Your vCard QR

Scan with: 1. iPhone: Should show "New Contact" or "Update Existing Contact" sheet 2. Android: Should open Contacts import dialog 3. Check: All fields populated correctly in the contact preview

Common errors: missing semicolons in the N: field, encoding issues with special characters (ampersands, accented letters), incorrect TEL type labels.

vCard 4.0 vs 3.0

vCard 4.0 adds IMPP (WhatsApp, Telegram handles), PHOTO via URI (keeps QR small), and KIND (person/org/group). iOS and Android support 4.0. If maximum device compatibility is a priority (including older devices), vCard 3.0 is the safer choice.

Putting this into practice

Start with the smallest real test you can run. Generate the code, print it at the exact size you plan to use, and scan it with two different phones in the lighting where it will live. Check that the destination page loads quickly on a mobile connection and that the call to action next to the code tells people what they will get. If anything feels slow or unclear, fix it before you print a full batch, because reprints cost more than a short test. Keep a note of the size, material, and placement that worked so the next batch starts from a proven setup.

Common mistakes to avoid

The most common mistakes are easy to avoid once you know them. Long payloads make modules tiny, low contrast makes edges hard to read, and text placed too close to the border eats the quiet zone the scanner needs. Covering a corner finder pattern with a logo or a sticker breaks detection entirely, and a code placed behind glare or on a curved surface fails even when the print is perfect. Review each of these points on a proof copy, and treat any failure as a reason to adjust the design rather than a reason to blame the scanner.

Quick checklist

- Keep the payload as short as practical so modules stay large. - Keep dark modules on a light background with strong contrast. - Leave a clear quiet zone on all four sides of the symbol. - Test the printed code at the real viewing distance and lighting. - Confirm the destination page loads fast on a phone. - Recheck the code after any change to the link, design, or placement.

Related tools and guides

- Use the [QR size calculator](/qr-size-calculator) to match the printed size to the expected scan distance before you commit to a print run. - The [error correction simulator](/error-correction-simulator) shows how damage tolerance changes the density of the symbol at each level. - The [vCard QR code generator](/vcard-qr-code-generator) builds contact codes that import cleanly on phones. - The [bulk vCard QR](/bulk-vcard-qr) tool builds contact codes for a whole team at once. - Test every code with the [QR scanner](/qr-scanner) on more than one phone before you publish or print it. - Create a fresh code with the [URL QR code generator](/url-qr-code-generator) when the destination is a web page.

Frequently Asked Questions

Will a vCard QR code update an existing contact on the phone?

When scanned, the phone shows a prompt asking whether to create a new contact or update an existing one (if it detects a matching name or email). The user chooses. The QR does not automatically overwrite existing data — it presents options to the user.

What is the maximum size vCard that fits in a QR code on a business card?

A typical vCard with name, title, company, one phone, one email, and website is approximately 200–300 characters — comfortably fitting in Version 5–7 QR at error correction Level M, which prints well at 25 × 25 mm. A vCard with address, multiple phones, and notes may push to Version 10+ — consider a redirect URL instead.

What information should a vCard QR code include?

Include a name, phone number, email, and organization at minimum. Add a website or address only when it helps the recipient, since every extra field makes the code denser and harder to scan.

Ready to generate high-precision QR codes?

Test your designs in real-time with our 100% client-side QR studio suite. Zero tracking, instant vector downloads.

Open QR Code Studio