To store multiple phone numbers in a vCard, give each number its own TEL line and label it with a TYPE such as cell, work or home. The vCard standard lets the phone property repeat, so a mobile, an office line and a fax can all sit in one contact file. The catch is the importing app: some keep only one number per label.
Why a vCard can hold multiple phone numbers
A vCard can hold several phone numbers because the TEL property is allowed to repeat. The vCard 4.0 specification gives TEL a cardinality of *, which means one or more instances may be present. It also states the general rule for any repeating field: write a new content line for each value, property name included.
There’s no list syntax and no commas between numbers. You write TEL again.
If you’re new to the format, the post on what a vCard file is covers the structure.
How to write each number on its own TEL line
Each phone number in a vCard goes on a separate TEL line, with a TYPE label that says what the number is for. Here’s a vCard 3.0 contact with three numbers:
BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
TEL;TYPE=cell,pref:0777 777 7777
TEL;TYPE=work,voice:+1-213-555-1234
TEL;TYPE=home,voice:020 666 6666
END:VCARD
To build one yourself:
- Open the
.vcffile in a plain text editor. - Find the existing
TELline. - Add a new line directly under it that starts with
TEL;TYPE=and the label you want. - Type a colon, then the number.
- Save the file with the
.vcfextension and import it on your phone.
Write numbers in full international format if the contact will be used abroad. Under vCard 4.0 the number is meant to be written as a tel: URI, but most phone address books still read the plain 3.0 style shown above.
Which TYPE labels to use for each number
The TYPE label tells the contacts app which field a number belongs in, such as Mobile, Work or Home. If you leave TYPE out, both the vCard 3.0 profile and vCard 4.0 treat the number as voice, which many apps file under a generic “Other” slot.
| Label | Meaning | Defined in |
|---|---|---|
cell |
Mobile phone | 3.0 and 4.0 |
work |
Phone at a place of work | 3.0 (also a general parameter in 4.0) |
home |
Phone at a residence | 3.0 (also a general parameter in 4.0) |
voice |
Voice line (the default) | 3.0 and 4.0 |
fax |
Fax number | 3.0 and 4.0 |
text |
Number that accepts SMS | 4.0 |
pager |
Pager | 3.0 and 4.0 |
You can combine labels on one line. Both versions accept either TYPE=work;TYPE=voice or the shorter TYPE=work,voice. A work mobile is commonly written TYPE=work,cell, and a personal mobile TYPE=home,cell, which is how one open-source contacts app stores them by default.
How to set the preferred number
To mark the number people should try first, flag it as preferred, but the syntax differs between vCard 3.0 and 4.0.
- vCard 3.0:
prefis just another TYPE value. WriteTEL;TYPE=cell,pref:.... - vCard 4.0: preference is its own parameter,
PREF, holding a whole number from 1 to 100. Lower means more preferred, and 1 is the top choice. A number with no PREF counts as least preferred.
A real export from Apple Contacts in 3.0 format shows the older style: the home number carries type=pref and the mobile line has no preference flag (sample file).
My take: use 3.0 syntax unless you know the receiving app reads 4.0. Phones open 3.0 files without complaint, and mixing the two styles in one file is how numbers end up in the wrong field.
How Outlook maps multiple phone numbers when you import a vCard
Outlook and Exchange have a fixed set of phone fields, so a vCard with many numbers only imports cleanly if the labels fit those slots. Microsoft’s vCard mapping document spells out where each TYPE lands:
| TEL TYPE in the file | Outlook field | What happens to extras |
|---|---|---|
home |
Home phone | A second home goes to Home 2 |
work |
Business phone | A second work goes to Business 2 |
cell |
Mobile phone | Only one Mobile field exists |
voice, msg, video, bbs, modem |
Other phone | Only the first goes in; additional ones are ignored |
pref |
Primary phone | n/a |
pcs |
Dropped | Not imported |
The voice row explains most “my second number disappeared” reports. Send a card with two untyped numbers and both default to voice; Outlook keeps the first and ignores the rest.
Worked example: a realtor has a personal mobile, an agency mobile and an office line. Plain TEL: lines would leave two of them behind in Outlook. Typing them as TYPE=cell,pref, TYPE=work and a second TYPE=work puts them in Mobile, Business and Business 2.
What goes wrong with multiple numbers in a vCard
Most problems with multiple numbers come from the app reading the file, not from the vCard format. Real cases:
- Phones that keep one number. Nokia S30+ feature phones allow one phone number per contact, so a .vcf import keeps only the first one.
- Exports that drop duplicates. One webmail address book was reported to export only the first number of each type, losing a second Work number.
- Missing labels. Untyped numbers all collapse into the default
voiceslot. - Wrong file version. A 4.0-style
PREF=1inside aVERSION:3.0file may be ignored.
The limitation: you can write a perfect file and still lose a number, because you don’t control the recipient’s app. Put the number that matters most first and mark it preferred, so it survives even a one-number importer.
If a card won’t import at all on an Apple phone, see why a vCard might not import on iPhone.
How to check that every number imported
After importing, open the contact and confirm each number sits under the label you meant. Then check:
- Import the
.vcfon an iPhone and on an Android phone if you can. - Open the contact and count the numbers.
- Check that the mobile sits under Mobile, not Other.
- Tap the preferred number to confirm it’s the one that dials by default.
- If you share contacts with Outlook users, import the file there too.
If you share your details as a QR code, more numbers mean a denser code; the vCard QR code guide covers when a link QR is the better choice. A QRCard profile, for example, keeps the contact data behind a link and generates a vCard 3.0 file when someone taps Save Contact. You can also set your phone number to shown, button only or hidden, which the post on sharing your phone number safely walks through.
FAQ
How many phone numbers can a vCard hold?
The vCard standard sets no upper limit. The TEL property may appear one or more times, so you can list as many numbers as you need. The app that imports the file may keep fewer.
How do I mark one number as the main one?
In vCard 3.0, add pref to that number’s TYPE list, for example TYPE=cell,pref. In vCard 4.0, use the separate PREF parameter with a value from 1 to 100, where 1 is the most preferred.
Why did only one of my numbers import?
Some apps keep only one number per type, or only the first number in the file. Give each number a different type where you can, and put the most important number first.
Can I put two numbers on one TEL line?
No. Each TEL line holds one phone number. To add a second number, add a second TEL line with its own TYPE label.