You tap a .vcf contact file and get a page of text starting with 'BEGIN:VCARD'. Or nothing happens. Or one person turns up out of a list of hundreds, or Google Contacts, iCloud or Outlook takes the file and adds nothing.
The file is usually fine. A VCF file, also called a vCard, is plain text in a standard layout that contacts apps know how to read. Most failures mean it opened in the wrong app, went somewhere that adds one contact at a time or wants a different file type, hit a size limit, or isn't quite the file it claims to be. Match what you see:
- A page of text starting with 'BEGIN:VCARD': it opened in a text viewer. See cause one.
- On an iPhone, nothing useful happens when you open it from Files or a chat app: see the iPhone section.
- Only some contacts arrive, or none: probably a limit, such as Google's 3,000 contacts per import or iCloud's 256 KB per vCard.
- Outlook adds one contact, or won't take the file at all: see the Outlook section.
- The importer can't see the file, or rejects it: see cause two.
Cause 1: The file opened in the wrong app
A vCard is text. The format's standard, RFC 6350, says it starts with the line 'BEGIN:VCARD' and that the 'VERSION' line must come immediately after it. When a text viewer, a notes app or a browser tab opens the file, that is exactly what you see. Nothing is broken. The file just needs to reach a contacts app.
Tapping it again usually opens the same app, so start from the contacts app or website instead, as each section below does. On Windows, Microsoft's help says a .vcf file opens in Outlook when Outlook is installed; if you wanted it in Google Contacts, import it from the Google Contacts page instead.
On iPhone: open it from Mail or Messages, or import it on iCloud.com
Apple's iPhone User Guide documents one way to import a vCard on the phone itself: tap a .vcf attachment in an email or message. If the file is in the Files app, or came through another app and opening it there does nothing useful, email it to yourself and tap it in Mail.
Apple's iPhone guide doesn't say how a file holding dozens of contacts is handled on the phone. Its iCloud.com import does: if the vCard contains contact information for more than one person, each contact becomes a separate entry. For a whole address book, use a computer:
- Go to icloud.com/contacts and sign in to your Apple Account if you're asked.
- Select the Add button on the right, choose 'Import vCard' and select the file. Apple says the contacts are added to the 'All Contacts' list.
- On the iPhone, go to Settings > [your name] > iCloud, tap 'See All' (or 'Show All') and turn on 'Contacts'. The phone must be signed in to the same Apple Account, or the new contacts won't show up.
- If the import fails, check the size. Apple's vCard import limits are 256 KB per vCard, photo and text together, 224 KB for the photo inside it, and 50,000 vCards in total. A large contact photo is the easiest way to go over.
- If nothing will import and your Apple Account is part of a Family Sharing group, Apple says Screen Time Communication Limits can stop you importing contacts. They are changed on an iPhone, iPad or Mac, not on iCloud.com.
On Android: import from the Contacts app, not from the download
Tapping a downloaded .vcf hands it to whichever app your phone picks for that kind of file, which isn't always your contacts app. Google's steps for its Contacts app start from the other end, and they handle a file with many contacts too:
- On your Android phone or tablet, open the Contacts app.
- At the bottom, tap 'Organize' and then 'Import from file'.
- If you have more than one account on the device, pick the account where you want to save the contacts. They will appear only there, so pick your Google Account if you also want them on the web.
- Find and select the VCF file to import.
- If your phone came with a different contacts app, these names won't match. Import the file at contacts.google.com on a computer instead and let your phone's Google Account sync it.
Gmail and Google Contacts: import on a computer, and mind the limits
For a Gmail account, the place to import a .vcf is Google Contacts, signed in to the same Google Account. Download the attachment from the email first, then:
- On your computer, go to contacts.google.com.
- On the left, click 'Import', then 'Select file'. If you don't find the menu on the left, click 'Menu' at the top left.
- Choose your file (vCard files have the .vcf extension) and click 'Import'.
- If it fails or stops short, Google lists three causes: importing more than 3,000 contacts at a time, reaching the limit of 25,000 contacts, or contacts that aren't formatted to work with Google Contacts. Google says to split more than 3,000 contacts into multiple files first; with a huge .vcf, export it again in smaller batches.
- Google's storage limits are 25,000 contacts or 20 MB with photos not included, and for each contact 128 KB, 1,024 characters per field (except 'Notes') and 500 fields.
- If a detail seems to be missing after the import, Google suggests checking that contact's notes section.
Outlook: one at a time in classic Outlook, CSV in new Outlook and Outlook.com
Classic Outlook for Windows (Outlook for Microsoft 365, 2024, 2021, 2019 and 2016) adds vCards one at a time. In the body of the email, click the vCard, right-click it and click 'Add to Outlook Contacts', then click 'Save & Close' in the contact window. Repeat for each vCard in the message.
New Outlook for Windows and Outlook.com import a CSV file; Microsoft's steps for both don't mention .vcf files. In new Outlook, select 'People' in the navigation bar, then 'Import contacts' on the ribbon, 'Browse', your CSV file, 'Open' and 'Import'. In Outlook.com it's 'People', then 'Manage contacts', then 'Import contacts'. Microsoft recommends UTF-8 encoding. If names look wrong in the import preview, cancel, save the file in Excel as 'CSV UTF-8 (Comma delimited)' and try again.
To turn a .vcf holding many contacts into a CSV, Microsoft's own route uses the Contacts folder built into Windows:
- In File Explorer, go to your Contacts folder (C:\Users\<username>\Contacts).
- Choose 'Import', then 'vCard (VCF file)', then 'Import'. Select the .vcf file, choose 'Open', choose 'OK' for each contact, then 'Close'.
- Choose 'Export', then 'CSV file', then 'Export'. Choose 'Browse', name the file, keep the default fields and choose 'Finish'.
- Import that CSV into Outlook. If you check it in Excel first, don't change the top row of headings. If Outlook.com says the format of the .csv file isn't correct, Microsoft suggests copying your data into its sample CSV file and testing with a few contacts before importing the full list.
Cause 2: The file isn't what it looks like
If the import fails everywhere, open the file in a plain text editor on a computer and check three things.
- One contact instead of hundreds. Each 'BEGIN:VCARD' line starts a contact, so count them. Microsoft's help calls exporting only one contact a common mistake. To export everything on iCloud.com, use the Select Menu button and 'Select All Contacts', then the Actions button and 'Export vCard'.
- The name doesn't end in .vcf. Google's importer looks for the .vcf extension, so a file saved as contact.txt or contact.vcf.txt may not show up when you browse for it. If its first line is 'BEGIN:VCARD', renaming it to end in .vcf is safe. If it starts with anything else, such as a web page's code, you saved the wrong thing; go back and save the original attachment.
- An older version or a different encoding. Apple, Google and Microsoft don't publish a list of the vCard versions they accept, so be wary of tables elsewhere that claim to know. The line after 'BEGIN:VCARD' shows the version. The current standard, vCard 4.0, uses UTF-8, and a file saved in an older character set can show odd symbols in place of accented letters. Try a fresh export from a current contacts app, or import the file at contacts.google.com, export those contacts again as a vCard and import the new file.
Make it work next time
Most of this disappears when nobody has to import a file, or when the file is small and arrives the way the phone expects.
- When you share your own details, send a link or a QR code as well as the file. A link opens in any browser and a QR code opens from the phone's camera, so they still work when the file doesn't.
- If you send a vCard, attach it to an email or a message rather than sending a download link. That is the route Apple documents on iPhone.
- Keep one person per file with a small photo. iCloud won't import a vCard over 256 KB, photo included.
- Move whole address books on a computer: icloud.com/contacts for an iPhone, contacts.google.com for Android and Gmail, and a CSV file for new Outlook and Outlook.com.
- Send the file to yourself first and open it on the kind of phone you're sending it to.
If you're the one handing out your details
A OneSol digital business card sidesteps most of this: it's a web page at a link like onesol.io/businesscard/yourname, with a QR code, that opens in any phone's browser with no app on either side, and you can change your details later without reprinting the code. Its 'Save contact' button still downloads a standard .vcf file, so the fixes above apply to that part too, but the card itself opens even when the file doesn't.
