vCard

Last updated Mar 05, 2026

Share contact information that can be saved directly to the user's address book.

Use cases

  • Business cards
  • Employee badges
  • Conference name tags
  • Networking events
  • Email signatures
  • Promotional materials

Properties

Personal Information

Property Type Description
firstName string First name
lastName string Last name
gender string Gender
title string Job title
organisation string Company or organization name
note string Additional notes
photo file Contact photo (resized to max 200x200px, stored as JPEG)

Contact Information

Property Type Description
tel Call Phone number (embedded Call object)
telType string Phone type (e.g., work, home, mobile)
email Email Email address (embedded Email object)
emailType string Email type (e.g., work, personal)
url Url Website URL (embedded Url object)

Address

Property Type Description
addressType string Address type (e.g., work, home)
addressLine1 string Street address line 1
addressLine2 string Street address line 2
addressCity string City
addressState string State or province
addressPostalCode string Postal/ZIP code
addressCountry string Country