vCard QR code generator

Fill in your contact details and generate a QR code that saves them straight into someone's phone contacts.

By QRotto · Updated · 6 min read

What a vCard QR code is

A vCard is the standard file format phones and email clients use to exchange contact details, the same format behind the “.vcf” attachment you get when someone shares a contact. A vCard QR code packs that file into a scannable image. Point a camera at it and the phone recognises the contact card and offers to save it, with the name, number, email, company and website already filled in.

The practical difference from a paper business card is what happens afterwards. A paper card gets photographed, put in a pocket, and typed up later, if at all. A vCard QR code puts the details in the phone's address book while you are still standing there.

The vCard QR code generator filled in with a name, company, phone number and email, showing the generated QR code alongside a download button.
The generator with a contact filled in. Decoding the code returns the same five fields that were entered, in vCard 3.0 format.

How to build yours

  1. Fill only the fields you want shared. Every field you add makes the code denser and slightly harder to scan, so leave out what you do not need.
  2. Write the phone number in international format. Start with the country code (+1, +44, +92). A number saved without it will not dial correctly from abroad.
  3. Include the full website URL. Write https://example.com, not example.com, so phones treat it as a link.
  4. Generate, then scan it yourself. Check the saved contact looks right before it goes on anything printed.

Keep it short. A vCard with five fields produces a clean, easily scanned code. Add a postal address, a job title, a second number and a note, and the pattern gets dense enough to fail on a small print or a low light scan.

vCard QR code vs a paper business card

Compared onPaper cardvCard QR code
Gets into the phoneOnly if typed up manuallyOne scan, one tap
Cost per contactPrinting cost each timeFree, unlimited
Details changeReprint the batchGenerate a new code
Works offlineYesYes, data is in the image
Physical presenceSomething to hand overNeeds a surface or screen

In practice, the two work best together: keep the paper card for the handshake, and print the QR code on the back so the details land in the phone without any typing.

Where to put your vCard QR code

On the back of a printed business card

The most common placement, and the most effective. The front stays a normal card; the back carries the code with a short instruction like “Scan to save my details”.

In your email signature

Useful for people who read your email on a laptop with a phone next to them, a quick scan and you are in their contacts. Keep the image around 120 to 150px so it does not dominate the signature.

On an event badge or lanyard

Conferences are where this earns its keep. Instead of exchanging cards with twenty people and losing half of them, attendees scan the badge and move on. Print the code large enough to scan from about arm's length.

On a shop window, van or job site sign

Tradespeople and local services use this so a passerby can save the number instantly instead of trying to remember it. Print it large, a code read from two metres away needs to be substantially bigger than one read from a table.

As a phone wallpaper or lock screen

A zero print option: set the code as your lock screen and let the other person scan your screen directly. It works surprisingly well at informal meetups.

Troubleshooting

The contact saves with the name in the wrong order

The vCard format stores a structured name field separately from the display name. Different phones read these differently, which is why a name occasionally lands in the wrong slot. Entering the full name as you want it displayed gives the most consistent result across devices.

The code is very dense and hard to scan

Too much data. Drop the fields you do not truly need, a postal address in particular adds a lot of characters. Fewer fields means a simpler pattern and a much more reliable scan.

The phone opens a browser instead of saving a contact

That usually means the code was generated as a URL rather than a vCard. Make sure you are using the vCard generator on this page rather than the URL generator.

Special characters look wrong in the saved contact

Semicolons and commas have structural meaning inside the vCard format and must be escaped, which this tool does automatically. If a name contains unusual characters and still looks off on one particular phone, simplify the entry.

What to include, and what to leave out

A vCard QR code is public the moment it is printed. Anyone who sees it can save your details, so treat it like information on a business card rather than private data.

Nothing you enter here is sent to a server, the code is generated entirely in your browser, as described in our privacy policy.

Which fields to include, and the format phones read

Which fields to include

The temptation is to fill in everything. Resist it. A code holding a name, a phone number and an email is sparse, forgiving and prints small. The same code with a full postal address, a job title, a second number and a website is noticeably denser and has to be printed larger to stay readable.

FieldInclude it?Why
NameAlwaysWithout it the saved contact is a nameless phone number
PhoneUsuallyThe main reason people save a contact
EmailUsuallyCheap in space and almost always wanted
CompanyIf relevantHelps people remember who you are months later
WebsiteOnly if shortA long URL costs more than it returns
Job titleRarelyIt is on the card already, in larger type
Postal addressRarelyThe most expensive field by a distance
PhotoNoIt does not fit. We measured this in detail

The photo row is not a style preference. A real photo cannot be made to fit inside a QR code at all, and even a tiny thumbnail pushes the code past what a business card can hold. We put numbers on it in can you put a photo in a vCard QR code.

If you want the exact millimetre cost of each field against the space on a business card, that is QR code for a business card.

What we measured: three ways to encode the same person

vCard is not the only format a phone will recognise. We took one complete contact, name, company, job title, mobile, email, website and a full postal address, and encoded it three ways at error correction level M. Then we decoded each code back and confirmed it matched.

The same contact encoded three ways. The vCard version is 270 characters, 65 by 65 modules and needs 29.2 mm. The MECARD version is 168 characters, 53 by 53 modules and needs 24.4 mm. A link to a contact page is 30 characters, 29 by 29 modules and needs 14.8 mm.
One person, three encodings. All three decoded correctly. The difference is entirely in how much text each format needs to say the same thing.
FormatCharactersGridSmallest usable print
vCard 3.0, full contact27065 x 6529.2 mm
vCard 4.0, full contact28465 x 6529.2 mm
MECARD, same contact16853 x 5324.4 mm
vCard 3.0, name and mobile and email only13349 x 4922.8 mm
MECARD, name and mobile and email only7137 x 3718.0 mm
A link to a contact page3029 x 2914.8 mm

The print sizes above are technical minimums for each grid. In print, never go below about 2 cm, the floor our sizing guide sets for any code.

MECARD is the compact alternative. It carries the same information in a terser syntax, and in our test it saved 4.8 mm of printed width in both the full and the trimmed version. That is a real saving on a business card where you have perhaps 15 mm to spend.

The catch is support. vCard is what phones have handled for decades and what every scanner expects. MECARD is widely recognised but not as universally as vCard, and nothing on a printed card tells a person which one they are about to scan. For something you print once and hand out for a year, we would take the 4.8 mm penalty and use vCard.

Trimming the fields beats changing the format. Dropping the address, title and website took vCard from 29.2 mm to 22.8 mm, a saving of 6.4 mm. That is more than MECARD bought us, it carries no compatibility question at all, and nobody misses the fields.

The last row is worth a thought if the code is going somewhere small. A link to a page with your details on it prints at 14.8 mm, half the width of the full vCard, and you can update the page afterwards. What you lose is the one scan that saves the contact directly, which is the whole appeal.

vCard 3.0 or 4.0

You may see generators offering a choice of version. The short answer is that 3.0 is the safer default, and our generator uses it.

We measured whether the version costs anything, and it does not. The same contact came out at 270 characters in 3.0 and 284 in 4.0, and both produced an identical 65 by 65 code. The extra characters fell inside the same size step, so the version choice is free.

Since it is free either way, pick on compatibility rather than size. Version 3.0 has been around far longer and is what the widest range of phones and apps read without complaint. Version 4.0 is the newer standard with tidier handling of some fields, but there is nothing in a normal business contact that needs it.

Frequently asked questions

Do people need an app to scan it?

No. Both iOS and Android read vCard QR codes from the built in camera and offer to create the contact.

Can I edit the contact details later?

Not in an existing code, the data is fixed inside the image. If your number or job changes, generate a new code and replace the old one. This is worth remembering before ordering 500 printed cards.

Does it expire?

No. Because nothing is stored on a server and there is no redirect involved, the code works indefinitely.

Can I track how many people scanned it?

Not with a static vCard code, there is no server in the loop to count scans. Tracking requires a dynamic code that redirects through a service, which is a different (and usually paid) product.

Related tools

If you are putting together materials for a business, a URL QR code pointing at your website or booking page pairs naturally with a vCard. Venues and rentals usually want a WiFi QR code as well, and a text QR code is handy for short printed instructions. The full list lives on our services page, and common questions are answered on the FAQ.

Putting this on a printed business card? We measured what each field costs in millimetres: a full vCard needs 27.6 mm of printed width against 14.8 mm for a link, which is why so many card codes end up too small to scan. The numbers are in QR code for a business card.

Wondering about a photo? The vCard format allows one, but a 32 pixel thumbnail takes the code from 45 by 45 modules to 125 by 125, and a real photo does not fit a QR code at all. We measured it in can you put a photo in a vCard QR code.

The format itself is documented in the vCard specification, if you want to see exactly which fields are supported.

QRotto

QRotto builds free browser based QR code generators and writes the guides that go with them. Every generator is verified by decoding the codes it produces and confirming the output matches the input exactly. See our editorial standards.