Formato del codice QR vCard: campi, versioni e un esempio funzionante
Che cosa contiene davvero un codice QR vCard: il formato di testo riga per riga, i campi che i telefoni capiscono, vCard 3.0, 4.0 e MECARD a confronto, e perché un contatto lungo produce un codice difficile da scansionare.
Questa guida mostra il formato riga per riga, quale versione usare, quanti dati ci stanno e quando conviene lasciare che un generatore di codici QR vCard memorizzi un link breve al posto del contatto completo.
Com'è fatto il formato vCard dentro un codice QR
Ecco un contatto completo e valido. Ogni riga è una proprietà: il nome del campo, i due punti e un valore.
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:VCARDTre regole tengono insieme il formato:
- La scheda inizia con BEGIN:VCARD e termina con END:VCARD, e la riga VERSION viene subito dopo la prima.
- Ogni proprietà sta su una riga a sé. Il punto e virgola separa le parti di un valore strutturato, come gli elementi di un nome o di un indirizzo.
- Una virgola, un punto e virgola o una barra rovesciata che fanno parte del testo vanno preceduti da una barra rovesciata, quindi «Smith, Jones and Co» si scrive «Smith\, Jones and Co».
I campi vCard che i telefoni capiscono
Un contatto può contenere decine di proprietà, ma queste sono quelle che le app contatti dei telefoni leggono in modo uniforme:
| Campo | Che cosa contiene | Esempio |
|---|---|---|
| FN | Il nome completo così come deve essere visualizzato. Obbligatorio. | FN:Alex Rivera |
| N | Il nome suddiviso in parti: cognome, nome, secondi nomi, prefisso, suffisso. Obbligatorio nella versione 3.0. | N:Rivera;Alex;;; |
| ORG | Azienda o organizzazione | ORG:Example Studio |
| TITLE | Qualifica | TITLE:Account Manager |
| TEL | Numero di telefono. TYPE lo indica come CELL, WORK o HOME. | TEL;TYPE=CELL:+12025550123 |
| Indirizzo email | EMAIL:[email protected] | |
| URL | Sito web | URL:https://example.com |
| ADR | Indirizzo postale in sette parti: casella postale, interno, via, città, stato o regione, CAP, paese. | ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA |
| NOTE | Una nota a testo libero | NOTE:Conosciuto alla fiera |
Scrivi i numeri di telefono in formato internazionale, con il prefisso del paese (per esempio +1 per gli Stati Uniti), così il contatto salvato si può chiamare correttamente da qualsiasi paese.
Il formato prevede anche un campo PHOTO, ma una foto dentro un codice QR non è pratica. Un'immagine incorporata occupa decine di migliaia di caratteri, mentre un codice QR arriva al massimo a 2.953 byte di dati. Lascia fuori la foto da un codice statico, oppure usa una scheda contatto ospitata che la mostri sulla pagina.
vCard 2.1, 3.0 o 4.0: quale versione usare
Sono in circolazione tre versioni del formato:
- vCard 2.1 (1996) è la più vecchia. La maggior parte dei telefoni la legge ancora, ma richiede markup aggiuntivo per i caratteri accentati e non latini.
- vCard 3.0 (1998) è la versione scritta dalla maggior parte dei generatori di codici QR ed è la scelta più sicura per un codice QR. Le fotocamere di iPhone e dei telefoni Android la leggono in modo affidabile.
- vCard 4.0 (2011) è lo standard attuale, definito nella RFC 6350. Usa sempre UTF-8 e ha una sintassi più pulita, ma le app fotocamera la supportano in modo meno uniforme, e secondo alcune segnalazioni certi telefoni perdono dei campi o mostrano male i caratteri speciali.
Usa la 3.0, a meno che tu non abbia un motivo preciso per fare diversamente, e salva il testo in UTF-8 perché i nomi con accenti o in alfabeti non latini arrivino intatti dopo la scansione.
MECARD: l'alternativa compatta
MECARD è un formato di contatto più breve, creato da NTT DOCOMO per i codici QR sui telefoni giapponesi. Mette l'intero contatto su una sola riga:
MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;Poiché usa meno caratteri, il codice QR è meno denso e si scansiona più facilmente in piccolo formato. Il rovescio della medaglia è che i campi sono meno: MECARD non ha spazio per il nome dell'azienda né per la qualifica, e il supporto varia tra le app di scansione più di quanto accada con vCard. Sceglilo solo quando il codice deve essere molto piccolo e bastano un nome, un numero e un'email.
Quanti dati di contatto ci stanno, e perché meno è meglio
Un codice QR può contenere fino a 2.953 byte, ma quello è il limite della versione più grande e densa, non un obiettivo. Ogni carattere che aggiungi ingrandisce il pattern: più moduli, ciascuno più piccolo a parità di dimensione di stampa.
Il contatto di esempio qui sopra è lungo 247 caratteri. Con una correzione degli errori di livello medio richiede un pattern largo 61 moduli: stampato largo 2,5 cm su un biglietto da visita, ogni modulo misura circa 0,4 mm. Un link breve di 22 caratteri richiede solo 25 moduli, quindi alla stessa dimensione ogni modulo misura 1 mm. Sono proprio i moduli più grandi a far sì che un codice si scansioni rapidamente con poca luce, su carta goffrata o con un telefono datato.
Per mantenere leggibile un codice vCard statico:
- Includi solo ciò che serve per contattarti: un nome, un numero di telefono, un'email e un sito web.
- Lascia fuori la foto, le note lunghe e l'indirizzo postale completo, a meno che non siano importanti.
- Stampalo più grande di quanto stamperesti un codice per un link. La guida alle dimensioni dei codici QR per la stampa riporta le dimensioni minime.
Codice vCard statico o scheda contatto dinamica
Ci sono due modi per associare un contatto a un codice QR.
Un codice vCard statico scrive il testo vCard direttamente nel pattern. Funziona senza connessione internet e senza alcun servizio alle spalle, e non scade mai. In compenso non si può modificare: un nuovo numero di telefono significa un nuovo codice e una ristampa.
Un codice vCard dinamico memorizza un link breve. La scansione apre una pagina con la scheda contatto e un pulsante Salva contatto, che scarica il file .vcf. Poiché i dati si trovano su un server, puoi modificarli dopo la stampa, il pattern resta piccolo e la pagina può mostrare una foto e link aggiuntivi.
| Domanda | Codice vCard statico | Codice vCard dinamico |
|---|---|---|
| Che cosa memorizza il pattern | L'intero testo vCard | Un link breve |
| Funziona offline | Sì | No, la scansione richiede una connessione |
| Modificabile dopo la stampa | No | Sì |
| Densità del pattern | Aumenta con ogni campo | Resta invariata |
| Foto | Poco pratica | Mostrata sulla scheda contatto |
| Dipende da un fornitore | No | Sì |
Per un biglietto da visita che distribuirai per anni, o per qualsiasi cosa stampata in grandi quantità, il dinamico è la scelta più sicura. Codici QR dinamici vs statici approfondisce il confronto in generale, e la guida al codice QR sul biglietto da visita tratta dimensioni e posizione sul biglietto stesso.
Come creare un codice QR vCard
Non serve scrivere il formato a mano. Un generatore di QR vCard lo costruisce a partire da un modulo:
- Apri il generatore di codici QR vCard di QR Cake.
- Inserisci nome, azienda, qualifica, numero di telefono, email e sito web. Aggiungi una foto e i tuoi profili social se vuoi che compaiano sulla scheda.
- Personalizza il codice con i tuoi colori, un logo o una cornice con un'etichetta come «Scansiona per salvare il mio contatto».
- Accedi con un account gratuito e salva il codice, poi scaricalo in PNG o SVG.
- Scansionalo con un iPhone e con un telefono Android, tocca Salva contatto su ciascuno e controlla il contatto salvato prima di stampare.
Un codice vCard salvato su QR Cake è dinamico. Il pattern contiene un link breve, la scansione apre la tua scheda contatto ospitata e Salva contatto scarica un file vCard 3.0 standard. Il piano gratuito include fino a 5 codici dinamici con scansioni illimitate, e i codici salvati non scadono. Con il piano gratuito compare una breve pagina pubblicitaria prima che si apra la scheda, e i piani a pagamento la rimuovono.
Come controllare che cosa contiene un codice QR vCard
Per vedere che cosa memorizza un codice esistente, scansionalo e guarda che cosa propone il telefono. Se compare l'anteprima di un contatto con l'opzione di aggiungerlo alla rubrica, il testo vCard si trova nel pattern e il codice è statico. Se compare un indirizzo web, il codice è dinamico. Puoi anche caricare una foto o uno screenshot del codice nel lettore di codici QR, che mostra il contenuto decodificato.
Errori comuni nei codici QR vCard
- Manca la riga VERSION o END:VCARD. In questo caso il telefono potrebbe mostrare il codice come testo semplice invece che come contatto.
- Virgole e punti e virgola senza barra rovesciata. Un nome aziendale come «Smith, Jones» si spezza in due valori se la virgola non è preceduta da una barra rovesciata.
- Troppi dati. Più numeri di telefono, una nota lunga e un indirizzo completo trasformano il codice di un biglietto da visita in un quadrato fittissimo che le fotocamere più vecchie non riescono a leggere.
- Una foto incorporata. Non ci sta. Se la foto è importante, usa una scheda contatto ospitata.
- Numeri di telefono senza prefisso internazionale. Un numero senza prefisso del paese non funziona per chi lo chiama dall'estero.
- Nessun test su entrambe le piattaforme. Le app contatti di iPhone e Android dispongono gli stessi campi in modo diverso, quindi controlla il contatto salvato su ciascuna.
In breve
Un codice QR vCard è un contatto in un formato di testo semplice: BEGIN:VCARD, una riga VERSION, un campo per riga, END:VCARD. Usa la versione 3.0, limita i campi all'essenziale e salva il testo in UTF-8. Se i dati potrebbero cambiare, o se il codice deve essere piccolo, usa un codice vCard dinamico che memorizza un link breve e mostra il contatto da una pagina che puoi modificare.
Generatore di QR code vCard
Crea un codice QR vCard, il biglietto da visita digitale. Una scansione mostra foto, telefono, email e indirizzo con il pulsante Salva contatto. Gratis e dinamico.
Il team di QR Cake
Scritto dal team di QR Cake, le persone che costruiscono QR Cake, una piattaforma di QR code dinamici usata per campagne stampate modificabili, QR code in Canva, analisi delle scansioni e reindirizzamenti QR di lunga durata che continuano a funzionare anche dopo la fine dell'abbonamento.
Scopri di più su QR CakeDomande frequenti
- Che formato usa un codice QR vCard?
- Usa il formato vCard, lo stesso testo semplice contenuto in un file .vcf. I dati iniziano con BEGIN:VCARD, proseguono con una riga VERSION e una proprietà per riga, come FN per il nome, TEL per il numero di telefono ed EMAIL per l'indirizzo email, e terminano con END:VCARD.
- Quale versione di vCard conviene usare per un codice QR?
- Usa vCard 3.0. È la versione scritta dalla maggior parte dei generatori di codici QR e quella che le fotocamere di iPhone e Android leggono in modo più uniforme. vCard 4.0 è lo standard più recente, ma le app fotocamera la supportano in modo meno omogeneo.
- Qual è la differenza tra vCard e MECARD?
- MECARD è un formato di contatto compatto creato da NTT DOCOMO che mette l'intero contatto su una sola riga. Usa meno caratteri, quindi il codice QR è meno denso, ma ha meno campi, senza spazio per il nome dell'azienda o la qualifica, e il supporto nelle app di scansione è più variabile.
- Quante informazioni può contenere un codice QR vCard?
- Un codice QR può contenere fino a 2.953 byte, ma un codice così pieno è troppo denso per essere scansionato in modo affidabile nel formato di un biglietto da visita. Limita un codice vCard statico a qualche centinaio di caratteri: un nome, un numero di telefono, un'email e un sito web.
- Un codice QR vCard può includere una foto?
- Non in un codice statico: una foto incorporata è molto più grande di quanto un codice QR possa contenere. Un codice vCard dinamico può mostrare una foto, perché la scansione apre una pagina con la scheda contatto ospitata invece di leggere il contatto dal pattern.
- Posso modificare un codice QR vCard dopo la stampa?
- Solo se è dinamico. In un codice vCard statico i dati di contatto sono scritti nel pattern, quindi ogni modifica richiede un nuovo codice. Un codice vCard dinamico memorizza un link breve, e puoi modificare in qualsiasi momento i dati a cui rimanda.
- Un codice QR vCard funziona senza connessione internet?
- Un codice vCard statico sì, perché il telefono legge il contatto direttamente dal pattern. Un codice vCard dinamico richiede una connessione, perché la scansione apre una pagina web che contiene il contatto.
Articoli correlati
Continua con guide pratiche sui codici QR, esempi e consigli per ottimizzare i risultati.
Codice QR sul biglietto da visita: dimensioni e posizione
Un codice QR su un biglietto da visita è l'uso del QR su carta con il ROI più alto in assoluto. Il biglietto dura quanto il suo design; la destinazione si aggiorna insieme alla tua carriera.
Codici QR dinamici vs statici: quale conviene davvero usare? (Guida 2026)
I codici statici vanno bene in circa tre situazioni precise. Per tutto il resto, i codici dinamici ti fanno risparmiare denaro, tempo e la figuraccia di dover ristampare i volantini perché qualcuno ha cambiato l'URL della landing page.
Dimensioni dei codici QR per la stampa: la guida 2026
I codici QR falliscono per dimensioni ridotte più che per qualsiasi altro motivo. La soluzione è semplice: stampali abbastanza grandi. Questa guida ti dà le regole, i numeri e le dimensioni minime caso per caso.