vCard QR guide
What a vCard QR code stores and how phones read it
A vCard QR code is not just a picture. It is a compact contact file encoded inside a scannable square. Understanding the fields helps you create a code that saves cleanly and avoids confusing the person who scans it.
What is vCard?
vCard is a standard format for exchanging contact information. Contact apps use it to move a person's name, phone number, email, organization, job title, website, and address from one device or app to another. When that same structured contact data is placed inside a QR code, a phone camera can recognize it and offer to save the details.
The format matters because it gives each detail a label. A phone number is not just text; it is a phone number. An email address is not just text; it is an email field. That is why a vCard QR code feels more useful than a plain QR code containing a paragraph of contact information.
Common fields inside a vCard QR code
A clean business card QR code usually contains these fields:
- Name: first name and last name, stored so contact apps can sort and display it correctly.
- Full name: the readable name shown in the contact card.
- Company: the organization, studio, agency, shop, or business name.
- Title: your role, such as founder, designer, consultant, manager, or technician.
- Phone: the number someone should actually use to reach you.
- Email: the address for follow-up, booking, support, or sales.
- Website: your homepage, profile, portfolio, booking page, or social profile.
- Address: optional, best used for storefronts, offices, clinics, studios, or service areas.
Best practice: do not overload the code. A vCard with every possible field can become dense and harder to scan at small sizes. Include the details that someone will use after meeting you.
How phones handle the scan
On modern iPhones and Android phones, the camera app or built-in scanning feature reads the QR code and detects the vCard format. The phone then shows an action such as adding a contact, creating a new contact, or opening the contact details for review. The user still chooses whether to save it.
Different phones may label fields slightly differently. For example, one device might show your number as mobile while another may simply show phone. That is normal. The goal is not pixel-perfect display across every contact app; the goal is to preserve the important information in the right general fields.
Why special characters are escaped
Names, addresses, and job titles sometimes contain commas, semicolons, or line breaks. In vCard files, those characters can have special meaning. A generator must escape them before encoding the QR code so the phone reads them as part of the value, not as separators. This is especially important for addresses and company names.
For example, "Suite 5, Main Street" should remain one address line. Without proper escaping, some readers may split it in unexpected ways. The generator on this site escapes common separators before sending the payload to the QR image service.
Privacy implications
A vCard QR code is convenient because it stores the contact details directly in the image. That also means the code is not private once you share it. Anyone who receives the image, photographs it, or finds it printed can scan the same details. Only include information intended for public or business use.
If your phone number changes, you need to generate a new code because the details are embedded in the image. This is different from a dynamic QR code that redirects through a server. The benefit of a static vCard QR code is that there is no account, no tracking dashboard, and no hosted contact page required.
When not to use a vCard QR code
Use a URL QR code instead when you want to send people to a page that changes often, such as a landing page, menu, promotion, booking calendar, payment link, or social profile. A URL can be updated on the destination page without reprinting the code, while a vCard image must be regenerated when the saved contact details change.