Isi vCard
vCard adalah teks biasa yang terdiri dari baris berlabel, dibuka BEGIN:VCARD dan ditutup END:VCARD. Setiap baris memuat satu properti, seperti nama terformat, nomor telepon, atau alamat email. Teks yang sama itulah isi file .vcf saat kontak diekspor dari ponsel atau program email.
vCard 3.0 minimal untuk QR code tampak seperti ini, satu properti per baris: BEGIN:VCARD, VERSION:3.0, N:Lee;Jordan, FN:Jordan Lee, ORG:Maple Street Bakery, TEL:+15035550123, EMAIL:jordan@example.com, URL:https://example.com, END:VCARD. N memuat nama terstruktur (nama keluarga lebih dulu, dipisah titik koma) dan FN nama seperti yang akan ditampilkan.
- N: nama terstruktur (keluarga;depan;tengah;awalan;akhiran)
- FN: nama tampilan
- TEL: nomor telepon, sebaiknya dalam format internasional
- EMAIL: alamat email
- ORG: perusahaan atau organisasi
- TITLE: jabatan
- URL dan ADR: situs web dan alamat pos
Versi mana yang dipakai
Versi 3.0 masih pilihan paling aman untuk QR code karena hampir semua ponsel membacanya. Versi ini didefinisikan dalam RFC 2426 tahun 1998. Versi 4.0, yang didefinisikan dalam RFC 6350 pada 2011, adalah standar terkini dan mewajibkan UTF-8, tetapi beberapa pembaca lama menanganinya kurang konsisten.
Versi 3.0 mengharapkan N dan FN, sedangkan 4.0 hanya mewajibkan FN. Versi mana pun yang dipakai, baris VERSION harus tepat setelah BEGIN:VCARD.
Untung-rugi ukuran dan pemindaian
Setiap kolom yang ditambahkan ke vCard menambah karakter, dan lebih banyak karakter berarti QR code lebih padat dengan modul lebih kecil. Kartu dengan nama, satu nomor telepon, dan satu email mudah di-scan bahkan pada ukuran kartu nama. Menambahkan alamat pos, beberapa nomor, catatan panjang, atau foto tertanam bisa mendorong kode ke versi yang perlu dicetak jauh lebih besar.
Foto biasanya jadi masalah: gambar yang di-encode base64 bisa mencapai ribuan karakter dan jarang muat di kode yang praktis. Alternatif umum adalah meng-encode link pendek ke file .vcf yang dihosting atau halaman kontak, yang menjaga kode tetap kecil dan memungkinkan detail diubah nanti.