vCard QR Code Format: Fields, Versions, and a Working Example

    QR Cake TeamPublished:

    What a vCard QR code actually contains: the text format line by line, the fields phones understand, vCard 3.0 vs 4.0 vs MECARD, and why a long contact makes a code that is hard to scan.

    A vCard QR code is a QR code whose data is a contact written in the vCard format: plain text that starts with BEGIN:VCARD, lists one detail per line, and ends with END:VCARD. When a phone camera reads that text, it recognizes a contact and offers to add it to the address book. A .vcf file contains exactly the same format.

    This guide shows the format line by line, which version to use, how much data fits, and when it is better to let a vCard QR code generator store a short link instead of the raw contact.

    What the vCard format looks like inside a QR code



    Here is a complete, valid contact. Each line is one property: a field name, a colon, and a value.

    BEGIN:VCARD
    VERSION:3.0
    N:Rivera;Alex;;;
    FN:Alex Rivera
    ORG:Example Studio
    TITLE:Account Manager
    TEL;TYPE=CELL:+12025550123
    EMAIL:[email protected]
    URL:https://example.com
    ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
    END:VCARD


    Three rules hold the format together:

    • The card starts with BEGIN:VCARD and ends with END:VCARD, and the VERSION line comes straight after the first one.
    • Each property sits on its own line. Semicolons separate the parts of a structured value, such as the pieces of a name or an address.
    • A comma, semicolon, or backslash that belongs to the text itself gets a backslash in front of it, so "Smith, Jones and Co" is written as "Smith\, Jones and Co".


    The vCard fields phones understand



    A contact can carry dozens of properties, but these are the ones that phone contacts apps read consistently:

    FieldWhat it holdsExample
    FNThe full name as it should be displayed. Required.FN:Alex Rivera
    NThe name in parts: family name, given name, middle names, prefix, suffix. Required in version 3.0.N:Rivera;Alex;;;
    ORGCompany or organizationORG:Example Studio
    TITLEJob titleTITLE:Account Manager
    TELPhone number. TYPE marks it as CELL, WORK, or HOME.TEL;TYPE=CELL:+12025550123
    EMAILEmail addressEMAIL:[email protected]
    URLWebsiteURL:https://example.com
    ADRAddress in seven parts: PO box, suite, street, city, state or region, postal code, country.ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
    NOTEA free-text noteNOTE:Met at the trade show


    Write phone numbers in international format with the country code, such as +1 for the United States, so the saved contact dials correctly from anywhere.

    The format also has a PHOTO field, but a photo is not practical inside a QR code. An embedded image runs to tens of thousands of characters, and a QR code tops out at 2,953 bytes of data. Leave the photo out of a static code, or use a hosted contact card that shows it on the page.

    vCard 2.1, 3.0, or 4.0: which version to use



    Three versions of the format are in circulation:

    • vCard 2.1 (1996) is the oldest. Most phones still read it, but it needs extra markup for accented and non-Latin characters.
    • vCard 3.0 (1998) is the version most QR code generators write and the safest choice for a QR code. The cameras on iPhone and Android phones read it reliably.
    • vCard 4.0 (2011) is the current standard, defined in RFC 6350. It always uses UTF-8 and has cleaner syntax, but camera apps support it less consistently, and some phones have been reported to drop fields or show special characters incorrectly.


    Use 3.0 unless you have a specific reason not to, and save the text as UTF-8 so that names with accents or non-Latin scripts survive the scan.

    MECARD: the compact alternative



    MECARD is a shorter contact format that NTT DOCOMO created for QR codes on Japanese phones. It puts the whole contact on one line:

    MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;


    Because it uses fewer characters, the QR code is less dense and scans more easily at small sizes. The trade-off is fewer fields: MECARD has no place for a company name or a job title, and support varies more between scanner apps than it does for vCard. Choose it only when the code must be very small and a name, a number, and an email are enough.

    How much contact data fits, and why less is better



    A QR code can hold up to 2,953 bytes, but that is the ceiling for the largest and densest version, not a target. Every character you add makes the pattern bigger: more modules, each one smaller at the same print size.

    The example contact above is 247 characters. At medium error correction it needs a pattern 61 modules wide, so printed 2.5 cm wide on a business card, each module is about 0.4 mm. A short link of 22 characters needs only 25 modules, which makes each module 1 mm at the same size. Larger modules are what let a code scan quickly in dim light, on textured paper, or with an older phone.

    To keep a static vCard code readable:

    • Include only what someone needs to reach you: a name, one phone number, one email, and a website.
    • Leave out the photo, long notes, and the full postal address unless they matter.
    • Print it larger than you would print a code for a link. The QR code size guide for print has the minimum sizes.


    Static vCard code vs dynamic contact card



    There are two ways to put a contact behind a QR code.

    A static vCard code writes the vCard text into the pattern itself. It works with no internet connection and no service behind it, and it never expires. It also cannot be changed: a new phone number means a new code and a reprint.

    A dynamic vCard code stores a short link. The scan opens a contact card page with a Save contact button, and that button downloads the .vcf file. Because the details live on a server, you can edit them after printing, the pattern stays small, and the page can show a photo and extra links.

    QuestionStatic vCard codeDynamic vCard code
    What the pattern storesThe full vCard textA short link
    Works offlineYesNo, the scan needs a connection
    Can be edited after printingNoYes
    Pattern densityGrows with every fieldStays the same
    PhotoNot practicalShown on the contact card
    Depends on a providerNoYes


    For a card you will hand out for years, or anything printed in volume, dynamic is the safer choice. Dynamic vs static QR codes covers the wider trade-off, and the business card QR code guide covers size and placement on the card itself.

    How to make a vCard QR code



    You do not need to type the format by hand. A QR vCard maker builds it from a form:

    1. Open the QR Cake vCard QR code generator.
    2. Enter your name, company, job title, phone number, email, and website. Add a photo and your social profiles if you want them on the card.
    3. Style the code with your colors, a logo, or a frame with a label such as "Scan to save my contact".
    4. Sign in with a free account and save the code, then download it as PNG or SVG.
    5. Scan it with an iPhone and an Android phone, tap Save contact on each, and check the saved entry before you print.


    A vCard code saved to QR Cake is dynamic. The pattern holds a short link, the scan opens your hosted contact card, and Save contact downloads a standard vCard 3.0 file. The free plan includes up to 5 dynamic codes with unlimited scans, and saved codes do not expire. On the free plan a brief ad page shows before the card opens, and paid plans remove it.

    How to check what a vCard QR code contains



    To see what an existing code stores, scan it and look at what the phone offers. A contact preview with an option to add it to your contacts means the vCard text is in the pattern, so the code is static. A web address means the code is dynamic. You can also upload a photo or screenshot of the code to the QR code reader, which shows the decoded content.

    Common vCard QR code mistakes



    • A missing VERSION or END:VCARD line. A phone may then show the code as plain text instead of a contact.
    • Unescaped commas and semicolons. A company name like "Smith, Jones" splits into two values unless the comma has a backslash before it.
    • Too much data. Several phone numbers, a long note, and a full address turn a business card code into a dense square that older cameras cannot resolve.
    • An embedded photo. It does not fit. Use a hosted contact card if the photo matters.
    • Local phone numbers. A number without a country code fails for anyone who dials it from abroad.
    • No test on both platforms. The contacts apps on iPhone and Android lay out the same fields differently, so check the saved entry on each.


    The short version



    A vCard QR code is a contact in a plain-text format: BEGIN:VCARD, a VERSION line, one field per line, END:VCARD. Use version 3.0, keep the fields to the essentials, and save the text as UTF-8. If the details might change, or the code has to be small, use a dynamic vCard code that stores a short link and serves the contact from a page you can edit.

    vCard QR Code Generator

    Create a vCard QR code, also called a contact card QR code. One scan shows your photo, phone, email, and address with a Save contact button. Free and dynamic.

    QR Cake Team

    About the QR Cake team

    Written by the QR Cake team - the people building QR Cake, a dynamic QR code platform used for editable print campaigns, Canva QR codes, scan analytics, and long-lived QR redirects that keep working after subscriptions end.

    Learn more about QR Cake

    Frequently asked questions

    What format does a vCard QR code use?
    It uses the vCard format, the same plain text found in a .vcf file. The data starts with BEGIN:VCARD, continues with a VERSION line and one property per line, such as FN for the name, TEL for the phone number and EMAIL for the email address, and ends with END:VCARD.
    Which vCard version should I use for a QR code?
    Use vCard 3.0. It is the version most QR code generators write and the one phone cameras on iPhone and Android read most consistently. vCard 4.0 is the newer standard, but camera apps support it less evenly.
    What is the difference between vCard and MECARD?
    MECARD is a compact contact format created by NTT DOCOMO that puts the whole contact on one line. It uses fewer characters, so the QR code is less dense, but it has fewer fields, with no place for a company name or a job title, and scanner app support varies more.
    How much information can a vCard QR code hold?
    A QR code can hold up to 2,953 bytes, but a code that full is too dense to scan reliably at business card size. Keep a static vCard code to a few hundred characters: a name, one phone number, one email, and a website.
    Can a vCard QR code include a photo?
    Not in a static code. An embedded photo is far larger than a QR code can store. A dynamic vCard code can show a photo, because the scan opens a hosted contact card page instead of reading the contact out of the pattern.
    Can I edit a vCard QR code after printing?
    Only if it is dynamic. A static vCard code has the contact details written into the pattern, so any change needs a new code. A dynamic vCard code stores a short link, and you can edit the details behind it at any time.
    Does a vCard QR code work without an internet connection?
    A static vCard code does, because the phone reads the contact straight from the pattern. A dynamic vCard code needs a connection, because the scan opens a web page that holds the contact.
    vCard QR Code Format: Fields, Versions, and a Working Example