vCard-QR-code: het formaat, de velden, de versies en een werkend voorbeeld

    QR Cake TeamGepubliceerd:

    Wat er echt in een vCard-QR-code staat: het tekstformaat regel voor regel, de velden die telefoons begrijpen, vCard 3.0 vs. 4.0 vs. MECARD, en waarom een lang contact een code oplevert die moeilijk te scannen is.

    Een vCard-QR-code is een QR-code waarvan de gegevens een contact in het vCard-formaat zijn: platte tekst die begint met BEGIN:VCARD, per regel één gegeven bevat en eindigt met END:VCARD. Leest een telefooncamera die tekst, dan herkent hij een contact en biedt hij aan het toe te voegen aan het adresboek. Een .vcf-bestand bevat precies hetzelfde formaat.

    Deze gids laat het formaat regel voor regel zien, welke versie je gebruikt, hoeveel gegevens erin passen en wanneer je een vCard-QR-codegenerator beter een korte link kunt laten opslaan in plaats van het ruwe contact.

    Zo ziet het vCard-formaat eruit in een QR-code



    Hier is een volledig, geldig contact. Elke regel is één eigenschap: een veldnaam, een dubbele punt en een waarde.

    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


    Drie afspraken houden het formaat overeind:

    • De kaart begint met BEGIN:VCARD en eindigt met END:VCARD, en de VERSION-regel volgt direct op de eerste.
    • Elke eigenschap staat op een eigen regel. Puntkomma's scheiden de delen van een gestructureerde waarde, zoals de onderdelen van een naam of een adres.
    • Een komma, puntkomma of backslash die bij de tekst zelf hoort, krijgt een backslash ervoor. “Smith, Jones and Co” schrijf je dus als “Smith\, Jones and Co”.


    De vCard-velden die telefoons begrijpen



    Een contact kan tientallen eigenschappen bevatten, maar dit zijn de velden die contacten-apps op telefoons consequent lezen:

    VeldWat erin staatVoorbeeld
    FNDe volledige naam zoals die moet worden weergegeven. Verplicht.FN:Alex Rivera
    NDe naam in delen: achternaam, voornaam, extra voornamen, titel vooraf, achtervoegsel. Verplicht in versie 3.0.N:Rivera;Alex;;;
    ORGBedrijf of organisatieORG:Example Studio
    TITLEFunctietitelTITLE:Account Manager
    TELTelefoonnummer. TYPE markeert het als CELL, WORK of HOME.TEL;TYPE=CELL:+12025550123
    EMAILE-mailadresEMAIL:[email protected]
    URLWebsiteURL:https://example.com
    ADRPostadres in zeven delen: postbus, extra adresregel, straat, plaats, provincie of regio, postcode, land.ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
    NOTEEen notitie in vrije tekstNOTE:Ontmoet op de vakbeurs


    Schrijf telefoonnummers in internationale notatie met de landcode, zoals +1 voor de Verenigde Staten, zodat het opgeslagen nummer vanaf elke plek ter wereld goed belt.

    Het formaat heeft ook een PHOTO-veld, maar een foto is in een QR-code niet praktisch. Een ingesloten afbeelding loopt op tot tienduizenden tekens, en een QR-code kan maximaal 2.953 bytes aan gegevens bevatten. Laat de foto weg uit een statische code, of gebruik een gehoste contactkaart die hem op de pagina toont.

    vCard 2.1, 3.0 of 4.0: welke versie gebruik je?



    Er zijn drie versies van het formaat in omloop:

    • vCard 2.1 (1996) is de oudste. De meeste telefoons lezen hem nog, maar voor letters met accenten en niet-Latijnse tekens is extra opmaak nodig.
    • vCard 3.0 (1998) is de versie die de meeste QR-codegenerators schrijven en de veiligste keuze voor een QR-code. De camera's van iPhone- en Android-telefoons lezen hem betrouwbaar.
    • vCard 4.0 (2011) is de huidige standaard, vastgelegd in RFC 6350. Hij gebruikt altijd UTF-8 en heeft een nettere syntaxis, maar camera-apps ondersteunen hem minder consequent, en van sommige telefoons is gemeld dat ze velden weglaten of speciale tekens verkeerd weergeven.


    Gebruik 3.0, tenzij je een specifieke reden hebt om dat niet te doen, en sla de tekst op als UTF-8, zodat namen met accenten of in een niet-Latijns schrift de scan heelhuids doorstaan.

    MECARD: het compacte alternatief



    MECARD is een korter contactformaat dat NTT DOCOMO heeft ontwikkeld voor QR-codes op Japanse telefoons. Het zet het hele contact op één regel:

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


    Omdat het minder tekens gebruikt, is de QR-code minder dicht en scant hij op klein formaat makkelijker. De keerzijde is dat er minder velden zijn: MECARD heeft geen plek voor een bedrijfsnaam of functietitel, en de ondersteuning verschilt meer tussen scanner-apps dan bij vCard. Kies het alleen als de code heel klein moet zijn en een naam, een nummer en een e-mailadres genoeg zijn.

    Hoeveel contactgegevens passen erin, en waarom minder beter is



    Een QR-code kan tot 2.953 bytes bevatten, maar dat is het plafond voor de grootste en dichtste versie, geen streefwaarde. Elk teken dat je toevoegt, maakt het patroon groter: meer modules, die bij hetzelfde drukformaat elk kleiner worden.

    Het voorbeeldcontact hierboven telt 247 tekens. Bij gemiddelde foutcorrectie is daarvoor een patroon van 61 modules breed nodig. Druk je het 2,5 cm breed op een visitekaartje, dan is elke module ongeveer 0,4 mm. Een korte link van 22 tekens heeft maar 25 modules nodig, waardoor elke module bij hetzelfde formaat 1 mm wordt. Juist grotere modules zorgen ervoor dat een code snel scant bij weinig licht, op papier met structuur of met een oudere telefoon.

    Zo houd je een statische vCard-code leesbaar:

    • Neem alleen op wat iemand nodig heeft om je te bereiken: een naam, één telefoonnummer, één e-mailadres en een website.
    • Laat de foto, lange notities en het volledige postadres weg, tenzij ze ertoe doen.
    • Druk hem groter af dan een code voor een link. De formaatgids voor QR-codes in drukwerk geeft de minimale formaten.


    Statische vCard-code vs. dynamische contactkaart



    Er zijn twee manieren om een contact achter een QR-code te zetten.

    Een statische vCard-code schrijft de vCard-tekst in het patroon zelf. Hij werkt zonder internetverbinding en zonder dienst erachter, en hij verloopt nooit. Hij kan ook niet worden gewijzigd: een nieuw telefoonnummer betekent een nieuwe code en opnieuw drukken.

    Een dynamische vCard-code slaat een korte link op. De scan opent een contactkaartpagina met een knop “Contact opslaan”, en die knop downloadt het .vcf-bestand. Omdat de gegevens op een server staan, kun je ze na het drukken aanpassen, blijft het patroon klein en kan de pagina een foto en extra links tonen.

    VraagStatische vCard-codeDynamische vCard-code
    Wat het patroon bevatDe volledige vCard-tekstEen korte link
    Werkt offlineJaNee, de scan heeft een verbinding nodig
    Na het drukken te bewerkenNeeJa
    Dichtheid van het patroonGroeit met elk veldBlijft gelijk
    FotoNiet praktischTe zien op de contactkaart
    Afhankelijk van een aanbiederNeeJa


    Voor een visitekaartje dat je jarenlang uitdeelt, of voor alles wat in oplage wordt gedrukt, is dynamisch de veiligere keuze. Dynamische vs. statische QR-codes behandelt de bredere afweging, en de gids over QR-codes op visitekaartjes gaat over formaat en plaatsing op het kaartje zelf.

    Zo maak je een vCard-QR-code



    Je hoeft het formaat niet met de hand te typen. Een vCard-QR-maker bouwt het op uit een formulier:

    1. Open de vCard-QR-codegenerator van QR Cake.
    2. Vul je naam, bedrijf, functietitel, telefoonnummer, e-mailadres en website in. Voeg een foto en je sociale profielen toe als je die op de kaart wilt hebben.
    3. Geef de code vorm met je kleuren, een logo of een kader met een label zoals “Scan om mijn contact op te slaan”.
    4. Log in met een gratis account, sla de code op en download hem daarna als PNG of SVG.
    5. Scan hem met een iPhone en met een Android-telefoon, tik op beide op Contact opslaan en controleer het opgeslagen contact voordat je drukt.


    Een vCard-code die je in QR Cake opslaat, is dynamisch. Het patroon bevat een korte link, de scan opent je gehoste contactkaart en Contact opslaan downloadt een standaard vCard 3.0-bestand. Het gratis abonnement bevat tot 5 dynamische codes met onbeperkte scans, en opgeslagen codes verlopen niet. Op het gratis abonnement verschijnt kort een advertentiepagina voordat de kaart opent. Betaalde abonnementen verwijderen die.

    Zo controleer je wat er in een vCard-QR-code staat



    Wil je zien wat een bestaande code bevat, scan hem dan en kijk wat de telefoon aanbiedt. Zie je een voorbeeld van een contact met de optie om het aan je contacten toe te voegen, dan staat de vCard-tekst in het patroon en is de code statisch. Zie je een webadres, dan is de code dynamisch. Je kunt ook een foto of screenshot van de code uploaden naar de QR-codelezer, die de gedecodeerde inhoud laat zien.

    Veelgemaakte fouten bij vCard-QR-codes



    • Een ontbrekende VERSION- of END:VCARD-regel. Een telefoon kan de code dan als platte tekst tonen in plaats van als contact.
    • Komma's en puntkomma's zonder backslash. Een bedrijfsnaam als “Smith, Jones” valt uiteen in twee waarden, tenzij er een backslash voor de komma staat.
    • Te veel gegevens. Meerdere telefoonnummers, een lange notitie en een volledig adres maken van een code voor een visitekaartje een dicht vierkant dat oudere camera's niet kunnen ontcijferen.
    • Een ingesloten foto. Die past er niet in. Gebruik een gehoste contactkaart als de foto belangrijk is.
    • Lokale telefoonnummers. Een nummer zonder landcode werkt niet voor wie het vanuit het buitenland belt.
    • Niet op beide platforms getest. De contacten-apps op iPhone en Android tonen dezelfde velden anders, dus controleer het opgeslagen contact op allebei.


    De korte versie



    Een vCard-QR-code is een contact in een formaat van platte tekst: BEGIN:VCARD, een VERSION-regel, één veld per regel, END:VCARD. Gebruik versie 3.0, beperk de velden tot het hoognodige en sla de tekst op als UTF-8. Kunnen de gegevens veranderen, of moet de code klein zijn, gebruik dan een dynamische vCard-code die een korte link bevat en het contact toont vanaf een pagina die je kunt bewerken.

    QR-code maken voor een vCard

    Maak een vCard-QR-code, ook wel contactkaart-QR-code genoemd. Eén scan toont je foto, telefoonnummer, e-mail en adres met een knop “Contact opslaan”. Gratis en dynamisch.

    QR Cake Team

    Over het QR Cake-team

    Geschreven door het QR Cake-team: de mensen achter QR Cake, een platform voor dynamische QR-codes dat wordt gebruikt voor aanpasbare printcampagnes, Canva QR-codes, scananalyses en duurzame QR-redirects die blijven werken nadat abonnementen aflopen.

    Meer weten over QR Cake

    Veelgestelde vragen

    Welk formaat gebruikt een vCard-QR-code?
    Het vCard-formaat, dezelfde platte tekst als in een .vcf-bestand. De gegevens beginnen met BEGIN:VCARD, gevolgd door een VERSION-regel en één eigenschap per regel, zoals FN voor de naam, TEL voor het telefoonnummer en EMAIL voor het e-mailadres, en eindigen met END:VCARD.
    Welke vCard-versie gebruik ik voor een QR-code?
    Gebruik vCard 3.0. Dat is de versie die de meeste QR-codegenerators schrijven en die telefooncamera's op iPhone en Android het consequentst lezen. vCard 4.0 is de nieuwere standaard, maar camera-apps ondersteunen die minder gelijkmatig.
    Wat is het verschil tussen vCard en MECARD?
    MECARD is een compact contactformaat van NTT DOCOMO dat het hele contact op één regel zet. Het gebruikt minder tekens, waardoor de QR-code minder dicht is, maar het heeft minder velden, zonder plek voor een bedrijfsnaam of functietitel, en de ondersteuning door scanner-apps verschilt meer.
    Hoeveel informatie kan een vCard-QR-code bevatten?
    Een QR-code kan tot 2.953 bytes bevatten, maar een code die zo vol zit, is op het formaat van een visitekaartje te dicht om betrouwbaar te scannen. Houd een statische vCard-code bij een paar honderd tekens: een naam, één telefoonnummer, één e-mailadres en een website.
    Kan een vCard-QR-code een foto bevatten?
    Niet in een statische code. Een ingesloten foto is veel groter dan wat een QR-code kan opslaan. Een dynamische vCard-code kan wel een foto tonen, omdat de scan een gehoste contactkaartpagina opent in plaats van het contact uit het patroon te lezen.
    Kan ik een vCard-QR-code na het drukken bewerken?
    Alleen als hij dynamisch is. Bij een statische vCard-code staan de contactgegevens in het patroon, dus voor elke wijziging is een nieuwe code nodig. Een dynamische vCard-code bevat een korte link, en de gegevens daarachter kun je op elk moment aanpassen.
    Werkt een vCard-QR-code zonder internetverbinding?
    Een statische vCard-code wel, omdat de telefoon het contact rechtstreeks uit het patroon leest. Een dynamische vCard-code heeft een verbinding nodig, omdat de scan een webpagina opent waarop het contact staat.
    vCard-QR-code: het formaat, de velden, de versies en een