upcScavenger » Computer File Formats » Wiki: Vcard

VCard

( Computer File Formats )

Media type
Example vCard files

vCard 2.1
vCard 3.0
vCard 4.0
xCard
jCard
hCard 1.0
h-card

Properties
vCard extensions
See also
References
External links

C O N T E N T S

Name Property String Vcard

Rank: 100%

Wiki
Comments
Media

vCard is a file format standard for electronic . vCards are often attached to e-mail messages, but can be exchanged in other ways, such as on the World Wide Web or instant messaging. They can contain name and address information, , e-mail addresses, URLs, , , and audio clips.

Media type

The standard Internet media type 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
       100 Waters Edge
                    Baytown, LA 30314
                    United States of America
     
   
   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

hCard 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
     
       Internet Email (preferred):
       forrestgump@example.com
     
     
       First Name: Forrest

       Last Name: Gump

     
       home
       42 Plantation St.
Baytown, LA 30314
United States of America
     
     
       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
       100 Waters Edge
Baytown, LA 30314
United States of America
     
     
       Work Address:

       100 Waters Edge

       Baytown, LA
       30314

       United States of America
     
     
        
        Work Phone:  1-404-555-1212

     vCard last updated:
     April 24, 2008 at 7:52 PM GMT

h-card

h-card is the microformats2 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>

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: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 Address Book UUID 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 Outlook (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
Telex contact information
TTY TDD 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 Internet media type text/vcard was used (incorrectly) in some SyncML Documentation to refer to vCard 3.0, and the example was followed in various implementations.

VCard

( Computer File Formats )

Forrest Gump

Account

Navigation

Statistics

VCard ( Computer File Formats )

Forrest Gump

Account

Navigation

Statistics

VCard

( Computer File Formats )