What Is a Contact Information QR Code?
A contact information QR code (also called a vCard QR code or contact QR code) holds your name, phone number, email, company and website in the vCard format — the same plain-text format as the .vcf files your phone and email app export. Scan it, and the phone shows a contact card with an Add to Contacts or Save button, every field filled in, no typing.
The short answer: write your details as a short vCard (BEGIN:VCARD … END:VCARD), paste it into the free generator’s Text tab, and download the code. Examples you can copy are further down.
vCard is an open IETF standard: RFC 2426 defines version 3.0 and RFC 6350 defines version 4.0. iPhone and Android cameras recognise vCard text inside a QR code and offer to save it. There are two ways to put a contact behind a QR code, and it pays to know the difference before you print anything:
- Embedded vCard — the contact text itself is inside the code. Works offline and instantly, but the details are fixed once printed, and every extra field makes the code denser.
- Linked vCard — the code holds a short web address that points to a
.vcffile or a contact page on your website. Needs an internet connection, but the code stays small, and you can update the details later by replacing the file.
Our free web generator has no vCard form — its types are URL, Text, Wi-Fi, Email and Phone. But its Text tab accepts multiple lines, so you can type or paste the vCard text yourself (Route 1) or point a URL code at a hosted .vcf file (Route 3). For a form-based contact card with colours and a logo, the Mac app Gen QR – Code Maker has a dedicated Contact card (vCard) type (Route 2).
How to Create a Contact Information QR Code: Four Routes
| Route | What the code holds | Best for | Trade-offs |
|---|---|---|---|
| 1. Free web generator, Text tab | Embedded vCard text you paste | Anyone, any device, no install; business cards and badges | You type the vCard lines yourself; plain black-and-white code; details fixed once printed |
| 2. Gen QR (Mac app) | Embedded vCard | Form-based entry; branded codes with colours or a logo | Details fixed once printed; Mac only |
| 3. Free web generator + hosted .vcf | URL to your .vcf file | Contacts that change, cards with a photo, very small codes | Needs internet and a place to host the file |
| 4. Free web generator + contact page | URL to a page on your site | Several links (contact, booking, portfolio) in one scan | One extra tap to save the contact |
Route 1: Free — Paste a vCard into the Text Tab
This is the quickest free way to turn contact information into a QR code, and it runs entirely in your browser (nothing is uploaded). The generator treats the Text tab as plain text and keeps line breaks, which is exactly what a vCard needs.
Make a contact QR code with the free generator
Copy a template. Take the minimal vCard from the examples below and paste it into any plain-text editor (TextEdit in plain-text mode, Notepad). Replace the sample values with yours.
Check the shape. The first line must be BEGIN:VCARD, the last END:VCARD, with VERSION:3.0, N: and FN: in between. Each property sits on its own line starting in the first column — no leading spaces, no blank line at the top.
Paste it into the Text tab of the generator. The preview updates as you type. Keep the card short: the shorter the text, the less dense and the easier to scan the code.
Download PNG or SVG. Use SVG if a designer will place the code in a card layout; PNG is fine for documents and screens.
Test before printing. Scan with the camera on an iPhone and on an Android phone, and confirm the save dialog shows your name, number and email correctly.
The trade-off: it is a static, embedded code, so changing a phone number later means making and reprinting a new one. If your details change often, use Route 3.
Route 2: Embedded vCard with Gen QR on Mac
Create a contact-card QR code
Open Gen QR and choose Contact card. Gen QR – Code Maker is a native macOS app; it works fully offline, so your contact details never leave your Mac.
Enter only what people need. Name, mobile, email and company are usually enough. A full postal address and several phone numbers make the code noticeably denser.
Style it if you want. Set foreground and background colours (keep the code dark on light), add a logo — error correction is raised automatically — or pick L/M/Q/H yourself.
Test on two phones. Scan with an iPhone and an Android phone and check every field in the save dialog, especially phone formats and accented names.
Export and organise. Export a high-quality image for your designer or printer. Keep the code in a project folder (with colour tags) so a new version takes a minute when your number changes; collage export puts two or four codes side by side on one printable sheet.
Route 3: A URL QR Code to a Hosted .vcf File (Free)
This is the free, browser-only route, and it has a real advantage: you can change the contact later without reprinting, because the code only points to a file you control.
Link a QR code to your contact file
Export your contact as .vcf. On a Mac, select your card in Contacts and choose File → Export → Export vCard. On iPhone, open the contact, tap Share Contact and save it to Files. Or write the file by hand using the format below, saved as UTF-8.
Upload it to your own website, for example https://yourdomain.com/contact/jane-smith.vcf. Ideally the server sends it with the content type text/vcard, so phones treat it as a contact rather than a random download.
Make a URL code. Paste that address into the URL tab of our free generator and download PNG or SVG. A short URL gives a small, easy-to-scan code — see the URL QR code guide.
Test on both platforms. On iPhone, Safari typically previews the contact with options to create or add it; on Android, the file downloads and opens in the Contacts app. If either misbehaves, check the file’s content type and encoding.
Update by replacing the file at the same address. The printed code keeps working as long as that URL stays live — so use your own domain, not a temporary file-sharing link.
A hosted file can also include a contact photo, which is far too large for an embedded code. The cost is that the scanner needs a connection, and you must keep the file online for as long as the code is in circulation.
Route 4: A contact page
If you want one scan to offer several things — save my contact, book a meeting, see my portfolio — point a URL code at a simple page on your site with a “Save contact” button that downloads your .vcf. It is one extra tap, but you control everything on the page and can change it any time. Add UTM parameters to the URL if you want to see visits from the code in your own analytics.
vCard Format Explained (BEGIN:VCARD)
Whichever route you choose, the contact itself is plain text. Here is a compact vCard 3.0 that scans well when embedded:
| Property | Meaning | Tip |
|---|---|---|
| BEGIN / END | Start and end of the card | Required, exactly BEGIN:VCARD … END:VCARD |
| VERSION | Spec version | 3.0 has the broadest support; required in 3.0 and 4.0 |
| N | Structured name: Family;Given;Additional;Prefix;Suffix | Required in 3.0; keep the semicolons even when parts are empty |
| FN | Display name | Required; what appears in the contact list |
| TEL | Phone, with TYPE=CELL, WORK, HOME… | Use international format (+country code) |
| Email address | One line per address | |
| ORG / TITLE | Company and job title | Optional |
| URL | Website | Pick your single most useful link |
| ADR | Address: PO Box;Extended;Street;City;Region;Postcode;Country | Adds a lot of characters — skip it if you can |
| PHOTO | Picture, usually base64 | Never embed in a QR code — far too large; fine in a hosted .vcf |
Formatting rules that trip people up:
- Escape commas, semicolons and backslashes inside text values with a backslash (
ORG:Smith\, Jones & Co), because those characters separate fields. - One property per line. The standard uses CRLF line endings; most phones also accept plain line feeds, but test.
- Save hosted files as UTF-8 so accented and non-Latin names display correctly.
Converting a .vcf file to a QR code
A .vcf exported from your phone is exactly this text, often with extra fields: a PHOTO, notes, social profiles, multiple addresses. For an embedded code, strip it down to the essentials above, or the code will be too dense to print small. For a linked code, upload the file as it is and create a URL code to it (Route 3). Capacity limits are covered in how much data a QR code can hold.
You may also see MECARD, an older single-line contact format from Japanese mobile phones (MECARD:N:Smith,Jane;TEL:+15551234567;EMAIL:jane@example.com;;). It is more compact than vCard but less widely documented; if you use it, test on both iPhone and Android.
Copy-Paste Contact QR Code Examples
Replace the sample values, keep the structure. All three use vCard 3.0 and the same lines you see in the table above. Each property goes on its own line with nothing indented.
1. Minimal card (smallest, easiest to scan)
Name, mobile and email. This is enough for most business cards and produces a code that scans quickly even when printed small.
2. Business card with company, title and website
Two phone numbers, a typed work email and a website. Each additional line makes the code a little denser, so add a field only if people will really use it.
3. With a postal address
The ADR value has seven semicolon-separated parts: PO box, extended address, street, city, region, postal code, country. The first two are empty here, hence ;; at the start. An address adds many characters, so use it for shops, clinics and offices where it matters.
The same contact as MECARD
MECARD packs a contact into one line: MECARD:N:Smith,Jane;TEL:+15551234567;EMAIL:jane.smith@example.com;;. It is shorter than vCard, but vCard is the better-documented standard, so prefer vCard unless you have a reason not to — and test MECARD on both iPhone and Android if you do use it.
QR Code Apps for Mac & Safari
Prefer generating codes without opening a browser tab? These two native Apple apps cover both habits — a full generator on the desktop, and a one-click share button inside Safari.
Embedded vs Linked: Which Contact QR Code Should You Use?
| Question | Embedded vCard | Linked .vcf / page |
|---|---|---|
| Works offline? | Yes | Needs internet |
| Change details after printing? | No — reprint | Yes — replace the file |
| Code density | Grows with every field | Small (short URL) |
| Contact photo | No | Yes, in the file |
| Depends on a website staying up? | No | Yes — your own domain |
| Make it with | Free generator Text tab, or Gen QR (Mac) | Free web generator (URL tab) |
Rule of thumb: embed for business cards, badges and anything that must work without signal; link when your details change often, when you want a photo, or when the code has to be printed very small. If you are designing a printed card, our business card QR code guide covers card layout, placement and print sizes in detail.
Troubleshooting: Contact QR Code Shows Text Instead of Saving
When a scan shows raw text, opens a web page, or saves the wrong field, the cause is almost always in the text you encoded:
- The phone shows plain text, not a contact. Check that the text starts exactly with
BEGIN:VCARDand ends withEND:VCARD, with no spaces before them and no typos in the keywords. A leading blank line or a stray character is enough to break recognition. - Some fields are missing. Each property must be on its own line. If your editor wrapped long lines or joined them, re-enter the line breaks. Also check you used a colon after the property name (
EMAIL:, notEMAIL=). - Curly quotes or odd characters. Word processors replace straight quotes and add invisible formatting. Write the vCard in a plain-text editor.
- The phone number does not dial or save correctly. Use the international format with a plus sign and country code, and no spaces or brackets.
- Accented or non-Latin names look garbled. Keep the text as UTF-8 and test with the exact name you intend to print.
- The code is hard to scan. Too much data. Trim the card, drop the address or second phone, or switch to a linked .vcf so the code only holds a short URL. See how much data a QR code can hold, and why QR codes fail to scan for print and contrast problems.
- Different phones behave differently. iPhone and Android cameras both recognise vCard, but the exact dialog and the apps offered vary by device and scanner app. This is why testing on both platforms matters.
Best Practices for Contact QR Codes
- Keep embedded cards short. Name, one phone, one email, company, title and a single URL is the sweet spot.
- Use international phone numbers (
+44…,+1…) so the number works for everyone who saves it. - Print it big enough. Aim for at least about 2.5 cm (1 in) square for an embedded vCard, larger if it has many fields. The QR code size guide has the details.
- Keep contrast high. Dark modules on a light background; leave the blank quiet zone around the code. A higher error-correction level helps a code survive wear but makes it denser.
- Add a label. “Scan to save my contact” tells people what will happen.
- Only share what you would print. Anyone who scans the code can read every field.
- Prefer a linked code if your details change often. A new job title or number then means replacing one file instead of reprinting a thousand cards.
- Test every version on an iPhone and an Android phone before it goes to print.
Where to Use a Contact Information QR Code
- Business cards — the classic. Card layout tips are in the business card guide.
- Conference and employee badges — contact swaps without hunting for cards; see QR codes on conference badges.
- Resumes and portfolios — recruiters save you in one scan (QR codes on resumes).
- Email signatures and slides — people can scan from a screen; a linked code keeps the image small.
- Reception desks and shop counters — save the business number for bookings and repeat orders.
Make Your Contact QR Code
Paste a vCard into the free generator, use the Contact card type in Gen QR on Mac, or link a hosted .vcf with a URL code.
Frequently Asked Questions
Write your details as a short vCard (BEGIN:VCARD, VERSION:3.0, N, FN, TEL, EMAIL, END:VCARD) and encode that text. In our free web generator, paste it into the Text tab, which accepts multiple lines, and download the code. Alternatively use the Contact card type in Gen QR on Mac, or upload a .vcf file to your own website and make a URL QR code to it.
It has no vCard form, but it can still make one. Its Text tab accepts multiple lines, so paste a vCard starting with BEGIN:VCARD and ending with END:VCARD and the code will save as a contact when scanned. You can also use the URL tab to link to a .vcf file or contact page you host.
For a linked code, upload the .vcf file to your website and create a URL QR code that points to it. For an embedded code, open the file in a plain-text editor, remove large fields such as PHOTO, keep the essential fields, and paste the text into the Text tab of the generator or a vCard type in an app.
BEGIN:VCARD is the first line of every vCard. It tells the phone that the following lines are contact fields, up to END:VCARD. When a scanner sees it inside a QR code, it offers to save the contact.
Use vCard 3.0 (RFC 2426). It has the broadest support on phones and contact apps. Version 4.0 (RFC 6350) is newer, but 3.0 is the safer choice for codes that strangers will scan.
Name, one phone number in international format, one email address, and optionally company, job title and a website. Add a postal address only if people need it, and leave out photos and long notes, because every extra field makes the code denser and harder to scan.
Not if the vCard is embedded, because the details are inside the printed pattern. If the code links to a .vcf file on your own website, you can update the contact by replacing the file at the same address.
An embedded vCard works offline: the phone reads the contact straight from the code. A code that links to a hosted .vcf file or contact page needs an internet connection to download it.
Usually the vCard text is slightly malformed. Check that it begins exactly with BEGIN:VCARD and ends with END:VCARD, that each property is on its own line with a colon after the name, and that no stray spaces, blank lines or curly quotes crept in. Write it in a plain-text editor and test on an iPhone and an Android phone.
A vCard QR code is a format: contact details in vCard text. A business card QR code is a placement: any code printed on a card, which might hold a vCard, a website or a LinkedIn link. Our business card guide covers design and placement on the card itself.