QR Code vCard Contact: Add Your Details in One Scan

A vCard QR code turns a business card into a one-scan contact transfer: the code holds your name, phone number, email, and other details, and the phone offers to save them. It works because the contact card is written directly into the code — no link, no account, no service that can shut down. The tricky part is getting the vCard text right and making the denser pattern print cleanly.

Use the free tool: QR Code Generator - private, in-browser.

What a vCard QR code actually contains

A vCard is a plain-text format for contact details. It starts with BEGIN:VCARD, lists fields such as name and phone number, and ends with END:VCARD. When that text is encoded in a QR code, most phone cameras recognise the format and show an "Add Contact" option instead of a wall of text.

There is no server in the middle. The contact data lives in the black-and-white pattern, which is why the code does not expire and does not need a subscription. It also means the details are fixed: changing them later requires a new code.

The fields worth including

Keep the card useful, not exhaustive. Every extra field adds characters, and more characters produce a denser QR pattern that is harder to print and scan.

| Field | What it does | Example | | --- | --- | --- | | N | Structured name: family; given; middle; prefix; suffix | N:Ng;Alex;;; | | FN | Display name | FN:Alex Ng | | ORG | Company | ORG:Northline Studio | | TITLE | Job title | TITLE:Product Designer | | TEL | Phone number and type | TEL;TYPE=CELL:+1-555-010-0142 | | EMAIL | Email address | EMAIL:alex@northline.example | | URL | Website or portfolio | URL:https://northline.example | | ADR | Address, split into seven parts | ADR;TYPE=WORK:;;12 Harbour Lane;Portland;OR;97201;USA | | NOTE | A short note, such as where you met | NOTE:Met at Design Week |

Skip photos, social profiles, and long notes unless they are essential. A contact vCard with ten fields can still scan well if it is printed large enough, but a short one gives you more margin for error on a small card.

Step-by-step: build a vCard QR code

1. Write the vCard in a plain-text editor

Use a text editor rather than a word processor so you do not pick up smart quotes or hidden formatting. Start with a minimal, complete card:

BEGIN:VCARD
VERSION:3.0
N:Ng;Alex;;;
FN:Alex Ng
ORG:Northline Studio
TITLE:Product Designer
TEL;TYPE=CELL:+1-555-010-0142
EMAIL:alex@northline.example
URL:https://northline.example
END:VCARD

Add fields only if they earn their space. For a business card, name, company, one phone number, one email address, and a website are usually enough.

2. Check the syntax before generating

Look for the three structural pieces: BEGIN:VCARD on the first line, VERSION:3.0 immediately after it, and END:VCARD on the last line. Every field needs a colon between its name and value. Semicolons separate the parts of structured fields such as N and ADR, so a missing semicolon shifts the data into the wrong slot.

3. Paste the text into the QR generator

Open the QR Code Generator and paste the entire vCard — including the begin and end lines — into the text field. The generator encodes whatever text you give it, so the vCard payload is the content of the code.

4. Set margin, contrast, and error correction

• Margin: set it to 4 modules. That creates the quiet zone the QR standard expects and gives phone cameras room to find the pattern.
• Colors: keep a dark foreground on a light background. Inverted or low-contrast codes are a common reason scans fail.
• Error correction: choose Q or H. A vCard payload is longer than a short URL, so the code has more modules; the extra redundancy helps when print is imperfect.

5. Export the right format

Download SVG for business cards and other print work. Vector output stays sharp at any size and avoids the soft edges that can blur a dense code. Use PNG for email signatures, slide decks, or a quick digital share.

6. Test the exact file you will print

Scan the downloaded code with an iPhone and an Android phone. Confirm the contact preview shows the right name, number, and email. Then print one proof at final size and scan that — screens and paper are not the same test. If you want a second opinion on sizing and materials, see QR codes for print.

vCard syntax mistakes that break contact cards

• Wrong name order. N is family name first, then given name: N:Ng;Alex;;;. FN is the friendly display name and should be written normally.
• Unescaped punctuation. Commas, semicolons, and backslashes inside a value need a backslash before them: NOTE:Met at Design Week\, Portland. A raw semicolon in a note can be read as a field separator.
• Stray blank lines. Keep the payload tight. Blank lines between fields make the data larger and can confuse strict parsers.
• Line-ending surprises. vCard 3.0 formally uses CRLF line endings. Many phone cameras accept ordinary line breaks, but test your exact payload on both platforms before committing to a print run.
• Typographic quotes and dashes. Straight ASCII punctuation is safer than curly quotes, especially in names and notes.
• Missing VERSION. Without a version line, some readers treat the payload as generic text rather than a contact.

vCard vs. URL vs. plain text

| Destination | Best for | Trade-off | | --- | --- | --- | | vCard | Instant contact saving at events, on cards, in email signatures | Fixed data; changing details means a new code | | URL | A profile page, booking link, or link hub you can update | Requires a hosted page and a scan that opens a browser | | Plain text | A short message or ID number | Not tappable or saveable as a contact |

For a business card, a vCard removes the most friction: one scan, one "Add Contact" tap, no typing. If your details change often or you need campaign attribution, a URL is the more flexible choice. The two can also coexist — a vCard on the card and a URL for a portfolio.

Printing a vCard code on a business card

A vCard payload is denser than a short URL, so give it more room than you would give a link code. Aim for at least 2 cm (0.8 in) square, and go to 2.5–3 cm if the design allows. Keep the code away from trim edges, folds, and textured backgrounds.

Matte stock is safer than a glossy finish because it reflects less light. If you add a logo, keep it small and increase error correction to H; on a dense vCard code, a large logo can do more harm than good. For layout ideas that leave room for a scannable code, see business card QR codes that work.

When your details change

A static vCard cannot be edited after printing. If a phone number or job title changes, generate a new code and reprint. That is the trade-off for a code that never depends on a third-party service. If you expect frequent changes, print a short URL instead and keep the contact details on a page you control.

Related tools

• Create a QR code — the same in-browser generator with a simpler starting point.
• QR code with logo — add a centered mark for branded cards.
• QR scanner — test a code with your camera before you print.