Does iCloud Support vCard 4.0? Which Version to Import
iCloud Contacts imports vCard 3.0 and Apple's older help says 3.0 and later, which includes 4.0 on paper. Some vCard 4.0 files still fail on iCloud.com, so version 3.0 is the safe choice. Jump to your situation below or work through the methods in order.
By Neeraj Singh ~5 min Updated Nov 2026 Checked against EA Help
Error message
Unable to import vCard. This vCard cannot be imported because it contains invalid contact data.
Summary
iCloud imports vCard 3.0 and Apple's older help says Contacts reads 3.0 and later, which includes 4.0 on paper. In practice some 4.0 files fail on iCloud.com with a could not read or invalid data message, and Apple's own Contacts app exports 3.0. Change VERSION:4.0 to VERSION:3.0 in a plain-text editor and import the file again. iCloud.com rejects version 2.1, so convert that to 3.0 as well. If 3.0 still fails, check the encoding, large photos and custom properties.
What the vCard version line does
A vCard file starts with BEGIN:VCARD and a VERSION line. That line decides which rules the file follows, and iCloud checks it when you import.
vCard 4.0 is the newer standard, published as RFC 6350 in 2011. It allows only UTF-8, puts VERSION:4.0 right after BEGIN:VCARD and defines properties like KIND, GENDER and LANG.
Apple's older iCloud help says Contacts imports vCard 3.0 and later, and Apple's Contacts app exports 3.0 files. Users still report that iCloud.com rejects some 4.0 files, which is why 3.0 is the version to use.
Which vCard versions work with iCloud
vCard 2.1 from Outlook 2007 or an Android export. iCloud.com rejects it, so change it to 3.0.
vCard 3.0 from Apple Contacts or Google Contacts. This is the version iCloud works with most reliably.
vCard 4.0 from newer apps and exports. Apple lists it as supported, yet some files fail with a could not read or invalid data message.
A 4.0 file with properties or encoding that the iCloud parser refuses.
A 3.0 file with a large photo, a byte order mark or custom X- properties.
✓ How to fix it
Method 1
Check the version line in your file
1Open the .vcf file in Notepad on Windows or in TextEdit set to plain text on a Mac.
2Find the line that starts with VERSION: right after BEGIN:VCARD.
BEGIN:VCARD
VERSION:4.0
FN:Ava Stone
N:Stone;Ava;;;
END:VCARD
3Version 2.1 and 4.0 files need Method 2. Version 3.0 files that still fail need the fixes in Method 5.
Method 2
Change vCard 4.0 to 3.0
1In the text editor, use Replace All to change VERSION:4.0 to VERSION:3.0. Do the same for VERSION:2.1.
2Remove 4.0 only lines like KIND, GENDER and LANG if the import still fails.
3Save the file as UTF-8.
4Go to icloud.com/contacts, sign in, open the actions menu in the sidebar and select the import option. Steps are on Apple's iCloud.com contacts guide.
Method 3
Import on your iPhone or Mac
1Email the .vcf file to yourself and open it on your iPhone, or open it in the Contacts app on a Mac.
2Select the option to add all contacts.
3Wait for iCloud sync to copy the contacts to icloud.com.
Method 4
Round-trip the file through Google Contacts
1Import the .vcf file into Google Contacts at contacts.google.com.
2Select the contacts and export them as a vCard for iOS Contacts. Google writes a fresh file in a format iCloud reads.
3Import that new file into iCloud.
Method 5
Fix photos, encoding and custom properties
1Save the file as UTF-8 without a byte order mark.
2Delete any contact that carries a large embedded photo and import it alone.
3Remove custom lines that start with X- if the file came from a CRM or an Android export.
4Import again. If one contact still fails, split the file in half and test both halves to find it.
iCloud imports vCard 3.0, and Apple's older help says Contacts reads 3.0 and later. Some 4.0 files still fail on iCloud.com, so change VERSION:4.0 to VERSION:3.0 in a plain-text editor, save as UTF-8 and import again. Version 2.1 is rejected, so convert it too.
Frequently asked questions
Does iCloud support vCard 4.0?
On paper yes, because Apple's older iCloud help says Contacts imports vCard 3.0 and later. Users still report that iCloud.com rejects some 4.0 files, so convert the file to version 3.0 for a reliable import.
Which vCard version does iCloud use?
Apple's Contacts app exports vCard 3.0 files, so 3.0 is the version iCloud works with most reliably.
How do I convert vCard 4.0 to 3.0?
Open the .vcf file in a plain-text editor, replace every VERSION:4.0 line with VERSION:3.0 and save the file as UTF-8. Remove 4.0 only properties like KIND, GENDER and LANG if the import still fails, then import the file again.
Does iCloud support vCard 2.1?
No. iCloud.com rejects version 2.1 files. Replace VERSION:2.1 with VERSION:3.0 in a text editor and import again.
What is the difference between vCard 3.0 and 4.0?
vCard 4.0 is defined in RFC 6350 from 2011. It allows only UTF-8, requires the VERSION line right after BEGIN:VCARD and adds properties like KIND, GENDER and LANG that 3.0 does not define.
Why does iCloud say invalid contact data for a 4.0 file?
iCloud checks files more strictly than Google Contacts or Outlook, and 4.0 adds rules and properties that 3.0 lacks. Convert the file to 3.0 and check the encoding, photo size and custom properties.
