vCard Not Importing on iPhone? Causes and Fixes

Nookesh Karri

A vCard usually fails to import on iPhone for one of four reasons: the file is in the old vCard 2.1 format, the file is malformed, the contact went into a different account than you’re looking at, or the file holds fewer contacts than you think. The quickest fix for most of them is to import the file on iCloud.com instead of on the phone, and to convert old 2.1 files to vCard 3.0 first.

First, check what’s in the file

Open the .vcf in any text editor before you blame the iPhone. A vCard is plain text, and RFC 6350, the spec for vCard, sets a few hard rules: each card starts with BEGIN:VCARD, ends with END:VCARD, has a VERSION line right after the start, and includes an FN (formatted name) line.

Three things to look for:

The version. The line after BEGIN:VCARD says VERSION:2.1, 3.0 or 4.0.
How many cards. Count the BEGIN:VCARD lines. That’s how many contacts are actually in the file.
Missing pieces. A card with no END:VCARD or no FN line breaks the rules, and a strict importer can reject it.

Cause 1: it’s an old vCard 2.1 file

According to the vCard article on Wikipedia, there are three versions in circulation: 2.1 from the Versit Consortium in 1996, 3.0 (RFC 2426), and 4.0 (RFC 6350). Older Android phones and some export tools still write 2.1.

The developer behind jahed.dev hit exactly this moving contacts off an old Android phone. The iCloud import failed with a vague error, something like “problem reading vcards.” After reading through forum threads, they wrote that “the single thing tying most of them together was the vCard version.” Their export was 2.1. They converted it to version 3 with a small open-source script and the import went through.

Fix: if the file says VERSION:2.1, convert it to 3.0 before importing. Re-exporting from the source app in a newer format works too, if the app offers it.

Cause 2: the file came from a spreadsheet

In one Apple Community thread, a user turned an Excel sheet into a CSV, then the CSV into VCF files, and Contacts answered with “Could not import some contacts.” The reply pointed them to importing through Contacts on iCloud.com.

Converted files are where the malformed cards come from: a blank name column becomes a card with no FN, a stray comma shifts every field over by one. Check a few cards in the text editor before you import hundreds.

Cause 3: it imported, just not where you’re looking

If you have iCloud, Gmail and an Exchange account all syncing contacts, a new contact lands in one of them, and your list may only be showing another.

Apple’s contacts management page says that with multiple accounts “you can choose a default account to add new contacts to.” Go to Settings > Apps > Contacts > Default Account and pick the one you actually use. Then open Contacts and check the lists at the top to make sure you’re viewing all accounts, not just one.

Cause 4: the file only has one contact in it

You expected your whole address book and got one person. Before blaming the import, count those BEGIN:VCARD lines. Microsoft, writing about moving iCloud contacts to Outlook, says the most common mistake “is they export only 1 contact from iCloud when they intended to export all of them.” If the file really has one card, the fix is on the export side.

If the file has many cards and you’re adding them from the phone, switch to iCloud.com. Apple’s iCloud import instructions are: go to icloud.com/contacts, click the Add button, choose Import Contact, and select the file. “If the vCard contains contact information for more than one person, each contact becomes a separate entry.” Those entries are saved to your iCloud account, and your iPhone shows them as long as Contacts is turned on for that account.

Cause 5: some fields just don’t come back

Sometimes the import works and pieces are missing. In an Apple Developer Forums thread from April 2026, a developer exported a contact from iOS Contacts with a name, phone, email, photo and LinkedIn profile, deleted it, and re-imported the same vCard 3.0 file. The name, phone and email came back. The photo and the LinkedIn profile did not, even though both were in the file. Nobody from Apple had replied when I checked.

I have no fix for this. I couldn’t find any Apple documentation listing which vCard fields iOS imports. That’s the hard limit of troubleshooting on iPhone: you can confirm a field is in the file, and you still can’t make iOS read it.

A real example

A small business owner switches from an old Android phone to an iPhone. The setup tool missed the contacts, so they export a .vcf from the Android phone, email it to themselves and tap it on the iPhone. The phone shows one contact, or an error.

Opening the file in a text editor shows VERSION:2.1 at the top and a few hundred BEGIN:VCARD lines. Two problems, then: an old version, and too many contacts to add from an attachment one at a time. They convert the file to 3.0 on a computer, import it at icloud.com/contacts, and the contacts show up on the iPhone.

My take

For more than a couple of contacts, skip the phone and import on iCloud.com. The phone is fine for one person’s card from a message or a QR code. For a whole address book, iCloud.com splits the file into proper entries, and when something fails you’re at a keyboard with the file open in an editor, not squinting at a preview sheet.

How QRCard handles this

When someone taps Save Contact on a QRCard profile, QRCard creates a standard vCard 3.0 file that opens straight in the iPhone or Android Contacts app, so the 2.1 problem above doesn’t come up. The person saving you needs a browser, nothing else.

It can’t fix the other side of the problem, though. If someone’s iPhone saves new contacts to an account they never look at, your card ends up there like any other contact.

If you’re not sure what a vCard is to begin with, start with what a vCard file is and how to open one. For what’s worth putting in the card, see what to put on a digital business card and digital business card best practices. On iPhone, adding your card to Apple Wallet is another way to keep it handy.

FAQ

Why does my iPhone say it could not import some contacts?

Something in the file didn’t parse. Common culprits are an old vCard 2.1 export or a file converted from a spreadsheet. Try importing it on iCloud.com instead, and if that also fails, convert it to vCard 3.0.

My contact imported but I can’t find it. Where did it go?

Probably into a different account. If you have several accounts in Contacts, new contacts go to the default account, which you set in Settings > Apps > Contacts > Default Account.

Why didn’t the photo come through when I imported a vCard?

iOS doesn’t always restore every field. A developer on Apple’s forums reported that a photo and a LinkedIn profile exported from iOS Contacts were not restored on re-import, even though the core fields were.

How do I import a vCard with hundreds of contacts to my iPhone?

Use Contacts on iCloud.com. Apple says each person in a multi-contact vCard becomes a separate entry, and they show up on an iPhone that has Contacts turned on for that iCloud account.

Why Does My vCard Not Import Contacts on iPhone?