vCard

Anfang der 1990er Jahre gründeten Apple, AT&T, IBM und Siemens das Versit Consortium, um gemeinsame Standards unter anderem für den Austausch persönlicher Daten (engl. personal data interchange, PDI) zu entwickeln. 1996 veröffentlichte das Versit Consortium die Spezifikation für vCard in der Version 2.1 und für vCalendar in der Version 1.0. Der Buchstabe v in vCard steht dabei nicht für „Visitenkarte“, sondern für den Herausgeber Versit.

Ende 1996 löste sich das Konsortium auf und übertrug alle Rechte an vCard an das Internet Mail Consortium (IMC).

Der standardisierte Inhaltstyp (MIME-Type) einer vCard lautet ab Version 4.0 der vCard-Spezifikation:[1]

text/vcard

Anderslautende Inhaltstypen gelten als überholt, beispielsweise:[1]

text/x-vcard

text/directory;profile=vCard

text/directory

In einigen SyncML-Dokumentationen in Bezug auf vCard 3.0 wurde fälschlicherweise statt text/x-vcard der MIME-Type text/vcard verwendet – und diesem Beispiel wurde in verschiedenen Implementierungen gefolgt – obwohl letzterer erst mit Version 4.0 standardisiert wurde.

Viele E-Mail-Programme können Kontaktdaten als vCard lesen und exportieren. Jedoch ist die Unterstützung oft fehlerhaft; eine vCard, die mit einem bestimmten Programm erstellt wurde, kann für ein anderes Programm unlesbar sein: Umlaute können verlorengehen etc. wenn Inhalte nicht gemäß den Spezifikationen mit den notwendigen Zeichensatz-Informationen abgespeichert werden. Eine vCard kann z. B. in der Version 2.1 die Adresse und den Namen mit unterschiedlichen Zeichensätzen speichern und muss den Zeichensatz jeweils angeben; eine Information ohne Angabe des Zeichensatzes sollte in Version 2.1 nur ASCII-Zeichen enthalten. Ab Version 3.0 sollte, ab Version 4.0 muss die gesamte Datei in UTF-8 codiert werden. Derzeit bietet das IMC keinen offiziellen Test, mit dem die Qualität einer vCard geprüft werden kann, oder eine Liste der Produkte, die vCards (zuverlässig) unterstützen.

Die übliche Dateinamenserweiterung für vCard-Dateien ist *.vcf = „vCard file“.

Spezifikation

vCard definiert nach der Referenzspezifikation RFC 6350 (August 2011)[2] die folgenden Objekttypen.

Eine vCard wird als einfache, unformatierte Textdatei gespeichert. Diese besteht aus einem oder mehreren vCard-Objekten, die durch die Begrenzungen BEGIN:VCARD und END:VCARD eingeschlossen werden. Alle vCards müssen die VERSION-Eigenschaft enthalten, die die vCard-Version spezifiziert. VERSION muss direkt auf BEGIN folgen (außer im vCard-2.1-Standard, wo es überall innerhalb der vCard vorkommen darf). Die Inhalte der vCard bestehen aus einzelnen Eigenschaften und deren Attributen. Die Eigenschaften können in beliebiger Reihenfolge wie folgt definiert werden:

EIGENSCHAFT[;PARAMETER]:Attribut[;Attribut]

= unterstützt und erforderlich

= unterstützt, nicht erforderlich

= als Eigenschaft nicht länger unterstützt, da jetzt als Parameter innerhalb anderer Eigenschaft nutzbar

= Sonderfall, unterstützt

Name	Version			Beschreibung	Beispiel
	2.1	3.0	4.0
ADR	unterstützt	unterstützt	unterstützt	Strukturierte Darstellung der physischen Anschrift des vCard-Objekts.	ADR;TYPE=home:;;Heidestrasse 17;Koeln;;51147;Germany
AGENT	unterstützt	unterstützt		Informationen über eine andere Person, die im Namen des vCard-Objekts handeln soll. Typischerweise ist das ein Vertreter, Assistent oder Sekretär. Hier kann entweder ein URL oder eine eingebettete vCard angegeben werden.	AGENT:http://de.wikipedia.org/wiki/007
ANNIVERSARY			unterstützt	Jahrestag (gemeint ist i. A. der Hochzeitstag[3]) der Person.	ANNIVERSARY:20140812 oder ANNIVERSARY:2014-08-12
BDAY	unterstützt	unterstützt	unterstützt	Geburtsdatum der mit der vCard verbundenen Person.	2.1, 3.0: BDAY:1964-08-12 4.0: BDAY:19640812 oder BDAY:1964-08-12
BEGIN	erforderlich	erforderlich	erforderlich	Jede vCard muss mit dieser Eigenschaft beginnen.	BEGIN:VCARD
CALADRURI			unterstützt	URL für das Senden einer Terminanforderung zur Verwendung des Kalenders der Person.	CALADRURI:http://example.org/kalender/emuster
CALURI			unterstützt	URL zum Kalender der Person.	CALURI:http://example.org/kalender/emuster
CATEGORIES	unterstützt	unterstützt	unterstützt	Liste von Eigenschaften, die das Objekt der vCard beschreiben.	CATEGORIES:swimmer,biker
CLASS		unterstützt		Sensibilität der in der vCard enthaltenen Daten.	CLASS:public
CLIENTPIDMAP			unterstützt	UUID für die Synchronisation verschiedener Revisionsstände derselben vCard.	CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
EMAIL	unterstützt	unterstützt	unterstützt	E-Mail-Adresse zur Kommunikation mit dem vCard-Objekt.	EMAIL:erika@mustermann.de
END	erforderlich	erforderlich	erforderlich	Jede vCard muss mit dieser Eigenschaft enden.	END:VCARD
FBURL			unterstützt	URL, der beschreibt, ob auf dem Kalender der Person „frei“ oder „besetzt“ angezeigt wird.	FBURL:http://example.org/fb/emuster
FN	unterstützt	erforderlich	erforderlich	Formatierte Zeichenfolge mit dem vollständigen Namen des vCard-Objekts.	FN:Dr. Erika Mustermann
GENDER			unterstützt	Geschlecht (biologisch) und Geschlechtsidentität der Person.[4]	GENDER:F GENDER:O;intersex
GEO	unterstützt	unterstützt	unterstützt	Längen- und Breitengrad.	2.1, 3.0: GEO:50.858;7.0885 4.0: GEO:geo:50.858\,7.0885
IMPP		unterstützt ⁠1)	unterstützt	Definiert ein Instant-Messenger-Handle. 1)  Dieses Objekt wurde vor Gültigkeit der vCard-Version 3.0 durch einen separaten RFC eingeführt. Deshalb kann vCards 3,0 diese Eigenschaft nutzen, auch wenn sie nicht Teil der Spezifikation 3.0 ist.	IMPP:aim:erika@mustermann.de
KEY	unterstützt	unterstützt	unterstützt	Öffentlicher Schlüssel, der dem vCard-Objekt zugeordnet ist. Es kann zu einem externen URL verwiesen werden, Klartext angegeben werden oder ein Base64-kodierter Textblock in die vCard eingebettet werden.	2.1: KEY;PGP:http://example.org/key.pgp 2.1: KEY;PGP;ENCODING=BASE64:[base64-data] 3.0: KEY;TYPE=PGP:http://example.org/key.pgp 3.0: KEY;TYPE=PGP;ENCODING=B:[base64-data] 4.0: KEY;MEDIATYPE=application/pgp-keys:http://example.org/key.pgp 4.0: KEY:data:application/pgp-keys;base64\,[base64-data]
KIND			unterstützt	Art des Objekts, das die vCard beschreibt: Eine Person (individual), eine Organisation (organization) oder eine Gruppe (group).	KIND:individual
LABEL	unterstützt	unterstützt	unterstützt ⁠2)	Stellt den eigentlichen Text dar, der auf einem physischen Adressetikett zur Adressierung an das mit der vCard verbundene Objekt vorhanden ist (ähnlich der ADR-Eigenschaft). 2)  Nicht unterstützt in Version 4.0. Stattdessen ist diese Information im LABEL-Parameter der ADR-Eigenschaft gespeichert.	LABEL;TYPE=HOME:Heidestrasse 17\n51147 Koeln\nDeutschland
LANG			unterstützt	Sprache, die die Person spricht.	LANG:de-DE
LOGO	unterstützt	unterstützt	unterstützt	Logo der Organisation, mit der die Person in Beziehung steht, der die vCard gehört. Es kann auf einen externen URL verwiesen oder ein Base64-kodierter Textblock in die vCard eingebettet werden.	2.1: LOGO;PNG:http://example.org/logo.png 2.1: LOGO;PNG;ENCODING=BASE64:[base64-data] 3.0: LOGO;TYPE=PNG:http://example.org/logo.png 3.0: LOGO;TYPE=PNG;ENCODING=b:[base64-data] 4.0: LOGO;MEDIATYPE=image/png:http://example.org/logo.png 4.0: LOGO:data:image/png;base64,[base64-data]
MAILER	unterstützt	unterstützt		Art des genutzten E-Mail-Programms.	MAILER:Thunderbird
MEMBER			unterstützt	Definiert das Objekt, das die vCard repräsentiert, als Teil einer Gruppe. Zulässige Werte sind: ein „mailto:“-URL, der eine E-Mail-Adresse enthält ein UUID, der auf die eigene vCard des Mitglieds verweist Um diese Eigenschaft verwenden zu können, muss die KIND-Eigenschaft auf „group“ gesetzt werden.	MEMBER:urn:uuid:550e8400-e29b-11d4-a716-446655440000
N	erforderlich	erforderlich	unterstützt	Strukturierte Darstellung von Namen der Person, Ort oder Sache, der das vCard-Objekt zugeordnet ist. (N:<Nachname>;<Vorname>;<zusätzliche Vornamen>;<Präfix>;<Suffix>)	N:Mustermann;Erika;;Dr.;
NAME		unterstützt		Textdarstellung der SOURCE-Eigenschaft.
NICKNAME		unterstützt	unterstützt	Ein oder mehrere Alternativnamen für das Objekt, das von der vCard repräsentiert wird.	NICKNAME:Erica,Ehrenreiche
NOTE	unterstützt	unterstützt	unterstützt	Zusätzliche Informationen oder Kommentar, welche mit der vCard in Verbindung stehen.	NOTE:Ich bin eine fiktive Person aus Deutschland\nund ich bin bundesweit bekannt.
ORG	unterstützt	unterstützt	unterstützt	Name und gegebenenfalls Einheit(en) der Organisation, der das vCard-Objekt zugeordnet ist. Diese Eigenschaft basiert auf den Attributen „Organization Name“ und „Organization Unit“ des X.520-Standards.	ORG:Google;GMail Team;Spam Detection Squad
PHOTO	unterstützt	unterstützt	unterstützt	Bild oder Fotografie der mit der vCard verbundenen Person. Es kann auf einen externen URL verwiesen oder ein Base64-kodierter Textblock in die vCard eingebettet werden.	2.1: PHOTO;JPEG:http://example.org/photo.jpg 2.1: PHOTO;JPEG;ENCODING=BASE64:[base64-data] 3.0: PHOTO;TYPE=JPEG:http://example.org/photo.jpg 3.0: PHOTO;TYPE=JPEG;ENCODING=b:[base64-data] 4.0: PHOTO;MEDIATYPE=image/jpeg:http://example.org/photo.jpg 4.0: PHOTO:data:image/jpeg;base64,[base64-data]
PRODID		unterstützt	unterstützt	Kennung für das Produkt, mit dem das vCard-Objekt erstellt wurde.	PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//DE
PROFILE	unterstützt	unterstützt		Legt fest, dass die vCard eine vCard ist.	PROFILE:VCARD
RELATED			unterstützt	Andere Einheit, zu der die Person Verbindung hat. Zulässige Werte sind: ein „mailto:“-URL, der eine E-Mail-Adresse enthält ein UUID, der auf die eigene vCard des Mitglieds verweist	RELATED;TYPE=friend:urn:uuid:550e8400-e29b-11d4-a716-446655440000
REV	unterstützt	unterstützt	unterstützt	Zeitstempel der letzten Aktualisierung der vCard.	REV:20140301T221110Z
ROLE	unterstützt	unterstützt	unterstützt	Rolle, Beruf oder Wirtschaftskategorie des vCard-Objekts innerhalb einer Organisation.	ROLE:Executive
SORT-STRING	unterstützt	unterstützt	unterstützt ⁠3)	Zeichenkette, die die Sortierreihenfolge der vCard in Anwendungen beschreibt. 3)  Nicht unterstützt in Version 4.0. Stattdessen wird diese Information im SORT-AS-Parameter der N- und/oder ORG-Eigenschaft gespeichert.	SORT-STRING:Mustermann
SOUND	unterstützt	unterstützt	unterstützt	Gibt standardmäßig die Aussprache der FN-Eigenschaft des vCard-Objekts an, wenn diese Eigenschaft nicht mit anderen Eigenschaften verknüpft ist. Es kann auf einen externen URL verwiesen oder ein Base64-kodierter Textblock in die vCard eingebettet werden.	2.1: SOUND;OGG:http://example.org/sound.ogg 2.1: SOUND;OGG;ENCODING=BASE64:[base64-data] 3.0: SOUND;TYPE=OGG:http://example.org/sound.ogg 3.0: SOUND;TYPE=OGG;ENCODING=b:[base64-data] 4.0: SOUND;MEDIATYPE=audio/ogg:http://example.org/sound.ogg 4.0: SOUND:data:audio/ogg;base64\,[base64-data]
SOURCE	unterstützt	unterstützt	unterstützt	URL, der verwendet werden kann, um die neueste Version dieser vCard zu erhalten.	SOURCE:http://mustermann.de/vCard.vcf
TEL	unterstützt	unterstützt	unterstützt	Normalform einer numerischen Zeichenkette für eine Telefonnummer zur telefonischen Kommunikation mit dem vCard-Objekt.	TEL;TYPE=CELL,HOME:(0170) 1234567 TEL;TYPE=VOICE,HOME:+4141310xxyy
TITLE	unterstützt	unterstützt	unterstützt	Angabe der Stellenbezeichnung, funktionellen Stellung oder Funktion der mit dem vCard-Objekt verbunden Person innerhalb einer Organisation.	TITLE:V.P. Research and Development
TZ	unterstützt	unterstützt	unterstützt	Zeitzone des vCard Objekts.	2.1, 3.0: TZ:+0100 4.0: TZ:Europe/Berlin
UID	unterstützt	unterstützt	unterstützt	UUID, der eine persistente, global eindeutige Kennung des verbundenen Objekts darstellt.	UID:urn:uuid:550e8400-e29b-11d4-a716-44665544ffff
URL	unterstützt	unterstützt	unterstützt	URL zu einer Website, die die Person repräsentiert.	URL:http://www.mustermann.de
VERSION	erforderlich	erforderlich	erforderlich	Version der vCard-Spezifikation. In den Versionen 3.0 und 4.0 muss diese auf die BEGIN-Eigenschaft folgen.	VERSION:3.0
XML			unterstützt	Beliebige mit der vCard verbundene XML-Daten. Wird verwendet, wenn die vCard in XML-codiert ist (xCard-Standard) und das XML-Dokument Elemente enthält, die nicht Teil des xCard-Standards sind.	XML:<b>kein XML-Element des xCard-Standards</b>

Manche Programme verwenden intern eine Datenbank mit einer Import-Methode für vCards, andere verwenden vCards als Dateiformat. Ein Export als vCard ist nicht immer möglich und die Unterstützung der Versionen 2.1, 3.0, 4.0 ist uneinheitlich:

• address manager
• Android
• Symbian
• Kontakte für macOS
• combit Relationship Manager
• EGroupware
• Kontact
• HCL Notes, Lotus Organizer
• Gmail
• Microsoft Outlook (eingeschränkt, nur der erste Kontakt wird importiert)
• Mozilla Thunderbird, mit Erweiterung MoreFunctionsForAddressBook .vcf-Datei-Editor oder CardBook
• Novell Evolution und GroupWise
• Nextcloud
• Open-Xchange
• ownCloud
• Roundcube
• SOGo
• Palm Desktop
• The Bat
• Trillian
• Horde (Framework)
• weitere Personal Information Manager (PIM)

Darüber hinaus bieten aktuelle Mobiltelefone einiger Hersteller die Möglichkeit, das Telefonbuch als vCard zu speichern, was den Datenabgleich (bspw. unter Linux) bedeutend komfortabler machen kann.

• LDAP Data Interchange Format
• iCalendar (vCalendar)
• MeCard (QR-Code)

• RFC 6350 – vCard Format Specification. August 2011 (Definition vCard Version 4.0, englisch).
• RFC 2426 – vCard MIME Directory Profile. September 1998 (Definition vCard Version 3.0, englisch).
• RFC 2425 – A MIME Content-Type for Directory Information. September 1998 (Definition vCard Version 2.1, englisch).
• Adressdaten als Microformat, hcard. microformats.org

1. RFC 6350 – vCard Format Specification. Abschnitt 10.1: Media Type Registration. (englisch).
2. RFC 6350 – vCard Format Specification. August 2011 (englisch).
3. RFC 6350 – vCard Format Specification. August 2011, Abschnitt 6.2.6: ANNIVERSARY. (englisch).
4. RFC 6350 – vCard Format Specification. August 2011, Abschnitt 6.2.7: GENDER. (englisch).
5. RFC 6474 – vCard Format Extensions: Place of Birth, Place and Date of Death. Dezember 2011 (englisch).
6. RFC 6715 – Web Host Metadata. Oktober 2011 (englisch).
7. RFC 4770 – vCard Extensions for Instant Messaging (IM). November 2007 (englisch).