Product Code Database
Example Keywords: winter -stitch $13-138
   » » Wiki: Vcard
Tag Wiki 'Vcard'.
Tag

vCard is a standard for electronic . vCards are often attached to messages, but can be exchanged in other ways, such as on the or . They can contain and information, , addresses, , , , and audio clips.


Media type
The standard for a vCard (often referred to as its mime type) is:RFC 6350, section 10.1 "Media Type Registration"
text/vcard

As of version 4.0 specification, other media types known to have been used previously are now deprecated, including:

text/x-vcard
text/directory;profile=vCard
text/directory


Example vCard files
The following is an example of a VCard file containing information for one person:


vCard 2.1
BEGIN:VCARD
VERSION:2.1
N:Gump;Forrest
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;GIF:http://www.example.com/dir_photos/my_photo.gif
TEL;WORK;VOICE:(111) 555-1212
TEL;HOME;VOICE:(404) 555-1212
ADR;WORK:;;100 Waters Edge;Baytown;LA;30314;United States of America
LABEL;WORK;ENCODING=QUOTED-PRINTABLE:100 Waters Edge=0D=0ABaytown, LA 30314=0D=0AUnited States of America
ADR;HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America
LABEL;HOME;ENCODING=QUOTED-PRINTABLE:42 Plantation St.=0D=0ABaytown, LA 30314=0D=0AUnited States of America
EMAIL;PREF;INTERNET:forrestgump@example.com
REV:20080424T195243Z
END:VCARD
     


vCard 3.0
BEGIN:VCARD
VERSION:3.0
N:Gump;Forrest;;Mr.
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;VALUE=URL;TYPE=GIF:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=WORK,VOICE:(111) 555-1212
TEL;TYPE=HOME,VOICE:(404) 555-1212
ADR;TYPE=WORK:;;100 Waters Edge;Baytown;LA;30314;United States of America
LABEL;TYPE=WORK:100 Waters Edge\nBaytown, LA 30314\nUnited States of America
ADR;TYPE=HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America
LABEL;TYPE=HOME:42 Plantation St.\nBaytown, LA 30314\nUnited States of America
EMAIL;TYPE=PREF,INTERNET:forrestgump@example.com
REV:2008-04-24T19:52:43Z
END:VCARD
     


vCard 4.0
BEGIN:VCARD
VERSION:4.0
N:Gump;Forrest;;;
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;MEDIATYPE=image/gif:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=work,voice;VALUE=uri:tel: 1-111-555-1212
TEL;TYPE=home,voice;VALUE=uri:tel: 1-404-555-1212
ADR;TYPE=work;LABEL="100 Waters Edge\nBaytown, LA 30314\nUnited States of America"
     
 :;;100 Waters Edge;Baytown;LA;30314;United States of America
     
ADR;TYPE=home;LABEL="42 Plantation St.\nBaytown, LA 30314\nUnited States of America"
:;;42 Plantation St.;Baytown;LA;30314;United States of America
     
EMAIL:forrestgump@example.com REV:20080424T195243Z END:VCARD


xCard
 
   
     
       
         work
       
     
     tel: 1-111-555-1212
   
   
     
       work
       
     
   
   forrestgump@example.com
 
     


jCard
["vcard",
 [
   ["version", {}, "text", "4.0"],
   ["n", {}, "text", ["Gump", "Forrest", "", "", ""]],
   ["fn", {}, "text", "Forrest Gump"],
   ["org", {}, "text", "Bubba Gump Shrimp Co"],
   ["title", {} ,"text", "Shrimp Man"],
   ["photo", {"mediatype":"image/gif"}, "uri", "http://www.example.com/dir_photos/my_photo.gif"],
   ["tel", {"type":["work", "voice"]}, "uri", "tel: 1-111-555-1212"],
   ["tel", {"type":["home", "voice"]}, "uri", "tel: 1-404-555-1212"],
   ["adr",
     {"label":"100 Waters Edge\nBaytown, LA 30314\nUnited States of America", "type":"work"},
     "text",
     ["", "", "100 Waters Edge", "Baytown", "LA", "30314", "United States of America"]
   ],
   ["adr",
     {"label":"42 Plantation St.\nBaytown, LA 30314\nUnited States of America", "type":"home"},
     "text",
     ["", "", "42 Plantation St.", "Baytown", "LA", "30314", "United States of America"]
   ],
   ["email", {}, "text", "forrestgump@example.com"],
   ["rev", {}, "timestamp", "2008-04-24T19:52:43Z"]
 ]
     
]


hCard 1.0
is an older microformat that allows a vCard to be embedded inside an HTML page. It has been superseded by /ref> 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.

 
   
 
 
   

Forrest Gump

First Name: Forrest
Last Name: Gump

     
     
Home Address:
42 Plantation St.
Baytown, LA 30314
United States of America
Home Phone: 1-111-555-1212

     
Organization: Bubba Gump Shrimp Co.
Title: Shrimp Man

     
     
Work Address:
100 Waters Edge
Baytown, LA 30314
United States of America
Work Phone: 1-404-555-1212

     vCard last updated:
     
   


h-card
is the update to hCard. http://microformats.org/wiki/h-cardhttp://microformats.org/wiki/microformats2


Properties
vCard defines the following property types.

All vCards begin with BEGIN:VCARD and end with END:VCARD. All vCards must contain the VERSION property, which specifies the vCard version. VERSION must come right after BEGIN (except in the vCard 2.1 standard, which allows it to be anywhere in the vCard). Otherwise, properties can be defined in any order.

= required
= supported
= special, supported
= not longer supported as a property but can be used as a parameter inside another property

ADR
ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA
AGENT
AGENT:<nowiki></nowiki>
ANNIVERSARY
ANNIVERSARY:19901021
BDAY
BDAY:19700310
BEGIN
BEGIN:VCARD
CALADRURI
CALADRURI:<nowiki></nowiki>
CALURI
CALURI:<nowiki></nowiki>
CATEGORIES
2.1, 3.0: CATEGORIES:swimmer,biker
4.0: CLASS
CLASS:public
2.1: CLIENTPIDMAP
2.1: CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
3.0: EMAIL
3.0: EMAIL:johndoe@hotmail.com
4.0: END
4.0: END:VCARD
FBURL
FBURL:<nowiki></nowiki>
FN
2.1: FN:Dr. John Doe
2.1: GENDER
3.0: GENDER:F
3.0: GEO
4.0: GEO:39.95;-75.1667
4.0: GEO:geo:39.95,-75.1667
IMPP
IMPP:aim:johndoe@aol.com
KEY
KEY;PGP:<nowiki></nowiki>
KEY;PGP;ENCODING=BASE64:[base64-data]
KEY;TYPE=PGP:<nowiki></nowiki>
2.1: KEY;TYPE=PGP;ENCODING=B:[base64-data]
2.1: KEY;MEDIATYPE=application/pgp-keys:<nowiki></nowiki>
3.0: KEY:data:application/pgp-keys;base64,[base64-data]
3.0: KIND
4.0: KIND:individual
4.0: LABEL
ADR
LABEL
ADR
LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA
LANG
LANG:fr-CA
2.1: LOGO
2.1: LOGO;PNG:<nowiki></nowiki>
3.0: LOGO;PNG;ENCODING=BASE64:[base64-data]
3.0: LOGO;TYPE=PNG:<nowiki></nowiki>
4.0: PHOTO;TYPE=PNG;ENCODING=B:[base64-data]
4.0: LOGO;MEDIATYPE=image/png:<nowiki></nowiki>
PHOTO:data:image/png;base64,[base64-data]
MAILER
MAILER:Thunderbird
2.1, 3.0: MEMBER
4.0: KIND
MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
N
N:Doe;John;;Dr;
NAME

A handful of separate specifications define additional vCard properties.

SOURCE
NICKNAME
NICKNAME:Jon,Johnny
NOTE
NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword.
ORG
ORG:Google;GMail Team;Spam Detection Squad
PHOTO


vCard extensions
vCard supports private extensions, with an "PHOTO;JPEG:<nowiki></nowiki>" prefix, a number of which are in common usage.

Some of these include:

Apple for that entry
arbitrary anniversary (in addition to PHOTO;JPEG;ENCODING=BASE64:[base64-data], birthday)
assistant name (instead of PHOTO;TYPE=JPEG:<nowiki></nowiki>)
manager name
spouse name
value PHOTO;TYPE=JPEG;ENCODING=B:[base64-data] or PHOTO;MEDIATYPE=image/jpeg:<nowiki></nowiki>
Instant Messaging (IM) contact information; PHOTO:data:image/jpeg;base64,[base64-data] parameter as for PRODID
string
string
string
string
string
string
string
string
IM address in VCF attachment from (right click Contact, Send Full Contact, Internet Format.)
Works as PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN or PROFILE. Contains an image of the Card in Outlook.
Contains XML used by Outlook describing the layout of the information presented as a business card.
alternative spellings, for assisting with the pronunciation of unfamiliar names
mail recipient prefers HTML-formatted email
Thunderbird specific settings
arbitrary anniversary (in addition to PROFILE:VCARD, birthday)
assistant name (instead of RELATED)
blog URL
file under different name (in addition to RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af, name components; and REV, full name)
manager name
spouse name
video chat address
callback phone number
radio contact information
contact information
TTY contact information
blog URL
arbitrary anniversary, in addition to REV:20121201T134211Z = birthday
assistant name (instead of ROLE)
im address
manager name
office description
profession
spouse name

Note: The text/vcard was used (incorrectly) in some Documentation to refer to vCard 3.0, and the example was followed in various implementations.


See also


External links

Page 1 of 1
1
Page 1 of 1
1

Account

Social:
Pages:  ..   .. 
Items:  .. 

Navigation

General: Atom Feed Atom Feed  .. 
Help:  ..   .. 
Category:  ..   .. 
Media:  ..   .. 
Posts:  ..   ..   .. 

Statistics

Page:  .. 
Summary:  .. 
4 Tags
10/10 Page Rank
378568 Page Refs