Editing VCard

{{short description|File format standard for electronic business cards}}
{{Lowercase title}}
{{redirect|.vcf|the bioinformatics text file format|Variant Call Format}}
{{refimprove|date=April 2021}}
{{Infobox file format
| name          = vCard
| icon          = 
| extension     = <code>.vcf</code>, <code>.vcard</code>
| mime          = text/vcard
| type code     = vCrd
| uniform type  = public.vcard
| owner         = Created by [[Versit Consortium]], all rights transferred in 1996 to [[Internet Mail Consortium]], all rights transferred in 2004 to CalConnect
| genre         = Electronic [[business card]]
| container for = Contact information
| contained by  =
| extended from =
| extended to   =
| standard      = {{IETF RFC|6350|link=no}}
}}

'''vCard''', also known as '''VCF''' ("Virtual Contact File"), is a [[file format]] standard for electronic [[business card]]s. vCards can be attached to [[e-mail]] messages, sent via [[Multimedia Messaging Service]] (MMS), on the [[World Wide Web]], [[instant messaging]], [[Near-field_communication|NFC]] or through [[QR code]]. They can contain [[Personal name|name]] and [[Address (geography)|address]] information, [[telephone number|phone numbers]], [[e-mail]] addresses, [[Uniform Resource Locator|URLs]], [[logo|logos]], [[photograph|photographs]], and audio clips.

vCard is used as a [[Electronic data interchange|data interchange]] format in [[smartphone]] contacts, [[personal digital assistant]]s (PDAs), [[personal information manager]]s (PIMs) and [[customer relationship management systems]] (CRMs). To accomplish these data interchange applications, other "vCard variants" have been used and proposed as "variant standards", each for its specific niche: [[XML]] representation, [[JSON]] representation, or [[HTML|web pages]]. 

== Overview ==
The standard Internet media type ([[MIME]] type) for a vCard has varied with each version of the specification.<ref name="mediatype">RFC 6350, section 10.1 "Media Type Registration"</ref>

vCards can be embedded in [[web pages]].

[[RDFa]] with the vCard Ontology can be used in HTML and various XML-family languages, e.g. SVG, MathML.

== Related formats ==
jCard, "The [[JSON]] Format for vCard" is a standard proposal of 2014 in {{IETF RFC|7095}}. RFC 7095 describes a lossless method of representing vCard instances in JSON, using arrays of sequence-dependent tag–value pairs. jCard has been incorporated into several other protocols, including [[Registration Data Access Protocol|RDAP]], the Protocol to Access [[TV_White_Space_Database|White Space]] Databases (PAWS, described in {{IETF RFC|7545}}), and [[Session Initiation Protocol|SIP]], which (via {{IETF RFC|8688}}) uses it to provide contact information for the operator of an intermediary which has rejected a call.

[[hCard]] is a microformat that allows a vCard to be embedded inside an HTML page. It makes use of [[CSS]] class names to identify each vCard property. Normal HTML markup and CSS styling can be used alongside the hCard class names without affecting the webpage's ability to be parsed by a hCard parser. h-card is the microformats2 update to hCard.

[[MeCard (QR code)|MeCard]] is a variation of vCard made by [[NTT Docomo|NTT DoCoMo]] for smartphones using [[QR code]]s. It uses a very similar syntax, but in a more consolidated way as the storage space on QR codes is limited. It's also limited in the amount of data that can be stored, not just by the standard but the size of QR codes.

== Example ==

An example of a simple vCard (from RFC 6350 of August, 2011, abbreviated):

  BEGIN:VCARD
  VERSION:4.0
  FN:Simon Perreault
  N:Perreault;Simon;;;ing. jr,M.Sc.
  BDAY:--0203
  GENDER:M
  EMAIL;TYPE=work:simon.perreault@viagenie.ca
  END:VCARD

This is the vCard for "Simon Perreault" (the author of RFC 6350), with his birthday (omitting the year), email address and gender.

== Properties ==
vCard defines the following property types.

All vCards begin with <code>BEGIN:VCARD</code> and end with <code>END:VCARD</code>.   All vCards must contain the <code>VERSION</code> property, which specifies the vCard version.  <code>VERSION</code> must come immediately after <code>BEGIN</code>, except in the vCard 2.1 and 3.0 standards, which allows it to be anywhere in the vCard. Otherwise, properties can be defined in any order.

{|class="wikitable sortable"
|- style="vertical-align:top;"
! rowspan="2" width="50" | Name
! colspan="3"            | Property presence
! rowspan="2"            | Description
! rowspan="2"            | Example
|-
! width="20" | {{abbr|v.|version}} 2.1<ref name="2.1specification.rtf">{{cite web |url=http://www.imc.org/pdi/vcard-21.rtf |title=vCard version 2.1 Specification |author=<!--Not stated--> |date=1996-09-18 |website=Internet Mail Consortium |publisher=versit |archive-url=https://web.archive.org/web/20150921154105/http://www.imc.org/pdi/vcard-21.rtf |access-date=2024-08-31|archive-date=21 September 2015 }}</ref>
! width="20" | {{abbr|v.|version}} 3.0
! width="20" | {{abbr|v.|version}} 4.0
|-
| <code>ADR</code> || {{optional}} || {{optional}} || {{optional}} || A structured representation of the physical delivery address for the vCard object. || <code>ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA</code>
|-
| <code>AGENT</code> || {{optional}} || {{optional}} || {{no|Undefined}} || Information about another person who will act on behalf of the vCard object. Typically this would be an area administrator, assistant, or secretary for the individual.  Can be either a URL or an embedded vCard. || <code>AGENT:<nowiki>http://mi6.gov.uk/007</nowiki></code>
|-
| <code>ANNIVERSARY</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Defines the person's anniversary. || <code>ANNIVERSARY:19901021</code>
|-
| <code>BDAY</code> || {{optional}} || {{optional}} || {{optional}} || Date of birth of the individual associated with the vCard. || <code>BDAY:19700310</code>
|-
| <code>BEGIN</code> || {{yes|Required}} || {{yes|Required}} || {{yes|Required}} || All vCards must start with this property. || <code>BEGIN:VCARD</code>
|-
| <code>CALADRURI</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || A URL to use for sending a scheduling request to the person's calendar. || <code>CALADRURI:<nowiki>http://example.com/calendar/jdoe</nowiki></code>
|-
| <code>CALURI</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || A URL to the person's calendar. || <code>CALURI:<nowiki>http://example.com/calendar/jdoe</nowiki></code>
|-
| <code>CATEGORIES</code> || {{no|Undefined}} || {{optional}} || {{optional}} || A list of "tags" that can be used to describe the object represented by this vCard. || <code>CATEGORIES:swimmer,biker</code>
|-
| <code>CLASS</code> || {{no|Undefined}} || {{optional}} || {{no|Undefined}} || Describes the sensitivity of the information in the vCard. || <code>CLASS:public</code>
|-
| <code>CLIENTPIDMAP</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Used for synchronizing different revisions of the same vCard. || <code><nowiki>CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b</nowiki></code>
|-
| <code>EMAIL</code> || {{optional}} || {{optional}} || {{optional}} || The address for electronic mail communication with the vCard object. || <code>EMAIL:johndoe@hotmail.com</code>
|-
| <code>END</code> || {{yes|Required}} || {{yes|Required}} || {{yes|Required}} || All vCards must end with this property. || <code>END:VCARD</code>
|-
| <code>FBURL</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Defines a URL that shows when the person is "free" or "busy" on their calendar. || <code>FBURL:<nowiki>http://example.com/fb/jdoe</nowiki></code>
|-
| <code>FN</code> || {{optional}} || {{yes|Required}} || {{yes|Required}} || The formatted name string associated with the vCard object. || <code>FN:Dr. John Doe</code>
|-
| <code>GENDER</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Defines the person's gender. || <code>GENDER:F</code>
|-
| <code>GEO</code> || {{optional}} || {{optional}} || {{optional}} || Specifies a latitude and longitude. || '''2.1''', '''3.0''': <code>GEO:39.95;-75.1667</code><br />'''4.0''': <code>[geo:39.95,-75.1667 GEO:geo:39.95,-75.1667]</code>
|-
| <code>IMPP</code> || {{no|Undefined}} || {{maybe}} || {{optional}} || Defines an instant messenger handle.

This property was introduced in a separate RFC when the latest vCard version was 3.0.  Therefore, 3.0 vCards might use this property without otherwise declaring it.
| <code>IMPP:aim:johndoe@aol.com</code>
|-
| <code>KEY</code> || {{optional}} || {{optional}} || {{optional}} || The public encryption key associated with the vCard object.  It may point to an external URL, may be plain text, or may be embedded in the vCard as a [[Base64]] encoded block of text. || style="font-size:0.8em" | '''2.1''': <code>KEY;PGP:<nowiki>http://example.com/key.pgp</nowiki></code><br />'''2.1''': <code>KEY;PGP;ENCODING=BASE64:[base64-data]</code><br />'''3.0''': <code>KEY;TYPE=PGP:<nowiki>http://example.com/key.pgp</nowiki></code><br />'''3.0''': <code>KEY;TYPE=PGP;ENCODING=b:[base64-data]</code><br />'''4.0''': <code>KEY;MEDIATYPE=application/pgp-keys:<nowiki>http://example.com/key.pgp</nowiki></code><br />'''4.0''': <code>KEY:data:application/pgp-keys;base64,[base64-data]</code>
|-
| <code>KIND</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Defines the type of entity that this vCard represents: 'application', 'individual', 'group', 'location' or 'organization'; 'x-*' values may be used for experimental purposes.<ref>{{cite web
| url=https://tools.ietf.org/html/rfc6350#section-6.1.4
| title=vCard Format Specification: 6.1.4. KIND
| date=August 2011
| publisher=[[IETF]]}}</ref><ref name=":0">{{cite web
| url=https://tools.ietf.org/html/rfc6473
| title=vCard KIND:application
| date=December 2011
| publisher=IETF}}</ref> || <code>KIND:individual</code>
|-
| <code>LABEL</code> || {{optional}} || {{optional}} || {{n/a|Incorporated without}} || Represents the actual text that should be put on the mailing label when delivering a physical package to the person/object associated with the vCard (related to the <code>ADR</code> property).

Not supported in version 4.0.  Instead, this information is stored in the <code>LABEL</code> parameter of the <code>ADR</code> property. Example: <code>ADR;TYPE=home;LABEL="123 Main St\nNew York, NY 12345":;;123 Main St;New York;NY;12345;USA</code>
| <code>LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA</code>
|-
| <code>LANG</code> || {{maybe|Mentioned}}<ref name="2.1specification.rtf" />{{rp|p=34}}|| {{no|Undefined}} || {{optional}} || Defines a language that the person speaks. || <code>LANG:fr-CA</code>
|-
| <code>LOGO</code> || {{optional}} || {{optional}} || {{optional}} || An image or graphic of the logo of the organization that is associated with the individual to which the vCard belongs.  It may point to an external URL or may be embedded in the vCard as a [[Base64]] encoded block of text. || style="font-size:0.8em" | '''2.1''': <code>LOGO;PNG:<nowiki>http://example.com/logo.png</nowiki></code><br />'''2.1''': <code>LOGO;PNG;ENCODING=BASE64:[base64-data]</code><br />'''3.0''': <code>LOGO;TYPE=PNG:<nowiki>http://example.com/logo.png</nowiki></code><br />'''3.0''': <code>LOGO;TYPE=PNG;ENCODING=b:[base64-data]</code><br />'''4.0''': <code>LOGO;MEDIATYPE=image/png:<nowiki>http://example.com/logo.png</nowiki></code><br />'''4.0''': <code>LOGO;ENCODING=BASE64;TYPE=PNG:[base64-data]</code>
|-
| <code>MAILER</code> || {{optional}} || {{optional}} || {{no|Undefined}} || Type of email program used. || <code>MAILER:Thunderbird</code>
|-
| <code>MEMBER</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Defines a member that is part of the group that this vCard represents.  Acceptable values include:{{Bulleted list| a "mailto:" URL containing an email address | a UID which references the member's own vCard }}The <code>KIND</code> property must be set to "group" in order to use this property. || <code><nowiki>MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af</nowiki></code>
|-
| <code>N</code> || {{yes|Required}} || {{yes|Required}} || {{optional}} || A structured representation of the name of the person, place or thing associated with the vCard object. Structure recognizes, in order separated by semicolons: Family Name, Given Name, Additional/Middle Names, Honorific Prefixes, and Honorific Suffixes<ref>{{cite web | url=https://www.rfc-editor.org/rfc/rfc2426#section-3.1.2 | title=RFC 2426: vCard MIME Directory, section 3.1.2| date=September 1998| last1=Dawson| first1=Frank| last2=Howes| first2=Tim}}</ref> || <code>N:Doe;John;;Dr;</code> 
|-
| <code>NAME</code> || {{no|Undefined}} || {{optional}} || {{no|Undefined}} || Provides a textual representation of the <code>SOURCE</code> property. ||
|-
| <code>NICKNAME</code> || {{no|Undefined}} || {{optional}} || {{optional}} || One or more descriptive/familiar names for the object represented by this vCard. || <code>NICKNAME:Jon,Johnny</code>
|-
| <code>NOTE</code> || {{optional}} || {{optional}} || {{optional}} || Specifies supplemental information or a comment that is associated with the vCard. || <code>NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword.</code>
|-
| <code>ORG</code> || {{optional}} || {{optional}} || {{optional}} || The name and optionally the unit(s) of the organization associated with the vCard object. This property is based on the X.520 Organization Name attribute and the X.520 Organization Unit attribute. || <code>ORG:Google;GMail Team;Spam Detection Squad</code>
|-
| <code>PHOTO</code> || {{optional}} || {{optional}} || {{optional}} || An image or photograph of the individual associated with the vCard.  It may point to an external URL or may be embedded in the vCard as a [[Base64]] encoded block of text. || style="font-size:0.8em" | '''2.1''': <code>PHOTO;JPEG:<nowiki>http://example.com/photo.jpg</nowiki></code><br />'''2.1''': <code>PHOTO;JPEG;ENCODING=BASE64:[base64-data]</code><br />'''3.0''': <code>PHOTO;TYPE=JPEG;VALUE=URI:<nowiki>http://example.com/photo.jpg</nowiki></code><br />'''3.0''': <code>PHOTO;TYPE=JPEG;ENCODING=b:[base64-data]</code><br />'''4.0''': <code>PHOTO;MEDIATYPE=image/jpeg:<nowiki>http://example.com/photo.jpg</nowiki></code><br />'''4.0''': <code>PHOTO;ENCODING=BASE64;TYPE=JPEG:[base64-data]</code>
|-
| <code>PRODID</code> || {{no|Undefined}} || {{optional}} || {{optional}} || The identifier for the product that created the vCard object. || <code>PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN</code>
|-
| <code>PROFILE</code> || {{no|Undefined}}|| {{optional}} || {{no|Undefined}} || States that the vCard is a vCard. || <code>PROFILE:VCARD</code>
|-
| <code>RELATED</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Another entity that the person is related to.  Acceptable values include:{{Bulleted list| a "mailto:" URL containing an email address | a UID which references the person's own vCard |a text value used to specify textual information}}|| <code><nowiki>RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af</nowiki></code>
|-
| <code>REV</code> || {{optional}} || {{optional}} || {{optional}} || A timestamp for the last time the vCard was updated. || <code>REV:20121201T134211Z</code>
|-
| <code>ROLE</code> || {{optional}} || {{optional}} || {{optional}} || The role, occupation, or business category of the vCard object within an organization. || <code>ROLE:Executive</code>
|-
| <code>SORT-STRING</code> || {{no|Undefined}} || {{optional}} || {{n/a|Incorporated without}} || Defines a string that should be used when an application sorts this vCard in some way.

Not supported in version 4.0.  Instead, this information is stored in the <code>SORT-AS</code> parameter of the <code>N</code> and/or <code>ORG</code> properties.
| <code>SORT-STRING:Doe</code>
|-
| <code>SOUND</code> || {{optional}} || {{optional}} || {{optional}} || By default, if this property is not grouped with other properties it specifies the pronunciation of the <code>FN</code> property of the vCard object.  It may point to an external URL or may be embedded in the vCard as a [[Base64]] encoded block of text. || style="font-size:0.8em" | '''2.1''': <code>SOUND;OGG:<nowiki>http://example.com/sound.ogg</nowiki></code><br />'''2.1''': <code>SOUND;OGG;ENCODING=BASE64:[base64-data]</code><br />'''3.0''': <code>SOUND;TYPE=OGG:<nowiki>http://example.com/sound.ogg</nowiki></code><br />'''3.0''': <code>SOUND;TYPE=OGG;ENCODING=b:[base64-data]</code><br />'''4.0''': <code>SOUND;MEDIATYPE=audio/ogg:<nowiki>http://example.com/sound.ogg</nowiki></code><br />'''4.0''': <code>SOUND:data:audio/ogg;base64,[base64-data]</code>
|-
| <code>SOURCE</code> || {{no|Undefined}} || {{optional}} || {{optional}} || A URL that can be used to get the latest version of this vCard. || <code>SOURCE:<nowiki>http://johndoe.com/vcard.vcf</nowiki></code>
|-
| <code>TEL</code> || {{optional}} || {{optional}} || {{optional}} || The canonical number string for a telephone number for telephony communication with the vCard object. || <code>TEL;TYPE=cell:(123) 555-5832</code>
|-
| <code>TITLE</code> || {{optional}} || {{optional}} || {{optional}} || Specifies the job title, functional position or function of the individual associated with the vCard object within an organization. || <code>TITLE:V.P. Research and Development</code>
|-
| <code>TZ</code> || {{optional}} || {{optional}} || {{optional}} || The time zone of the vCard object. || '''2.1''', '''3.0''': <code>TZ:-0500</code><br />'''4.0''': <code>TZ:America/New_York</code>
|-
| <code>UID</code> || {{optional}} || {{optional}} || {{optional}} || Specifies a value that represents a persistent, globally unique identifier associated with the object. || <code><nowiki>UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b</nowiki></code>
|-
| <code>URL</code> || {{optional}} || {{optional}} || {{optional}} || A URL pointing to a website that represents the person in some way. Default = "homepage" || <code>URL;TITLE:<nowiki>https://www.johndoe.com</nowiki></code>
|-
| <code>VERSION</code> || {{yes|Required}} || {{yes|Required}} || {{yes|Required}} || The version of the vCard specification.  In version 4.0, this must come right after the <code>BEGIN</code> property. || <code>VERSION:3.0</code>
|-
| <code>XML</code> || {{no|Undefined}} || {{no|Undefined}} || {{optional}} || Any XML data that is attached to the vCard. This is used if the vCard was encoded in XML (xCard standard) and the XML document contained elements which are not part of the xCard standard. || <code>XML:&lt;b&gt;Not an xCard XML element&lt;/b&gt;</code>
|-
|}

== See also ==
* [[CardDAV]]
* [[FOAF (ontology)]]
* [[Geo URI scheme]]

== References ==
{{Reflist}}

== External links ==
* [https://devguide.calconnect.org/vCard/vcard-4/ vCard 4.0] at its developer CalConnect
*{{IETF RFC|6350}} describing the vCard format version 4
*[https://web.archive.org/web/20150906130553/http://www.imc.org/pdi/ vCard and vCalendar] (old versions) from the [[Internet Mail Consortium]] in the [[Internet Archive]]

[[Category:Computer file formats]]
[[Category:Business cards]]
[[Category:Internet Standards]]