All posts
Guides··8 min read

VCF file not opening? Why a vCard won't import on iPhone, Android, Gmail or Outlook

A .vcf contact file that opens as a page of text starting with 'BEGIN:VCARD', adds only one person, or gets turned down by Google Contacts, iCloud or Outlook is usually not broken. Here is why each one happens and the fix for each platform, in Apple's, Google's and Microsoft's current wording.

OneSol Team

A woman sorts blank contact cards, folders, labels, and a hard drive at a sunlit neighborhood print shop.

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.
Make a free OneSol digital business card. It's a link and a QR code that open in any phone's camera and browser, iPhone or Android, and one tap saves you to their contacts.See the free card →

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.

Want a card that opens every time?Make a free OneSol digital business card. It's a link and a QR code that open in any phone's camera and browser, iPhone or Android, and one tap saves you to their contacts.See the free card →

Still stuck? More fixes

Frequently asked questions

Why won't a VCF file open on my iPhone?

Often because it was opened somewhere that handed it to the wrong app. Apple's iPhone guide documents importing a vCard by tapping a .vcf attachment in an email or message, so email the file to yourself and tap it in Mail. For a file with many contacts, use a computer: go to icloud.com/contacts, select the Add button, choose 'Import vCard' and pick the file, then make sure Contacts is turned on under Settings > [your name] > iCloud on the iPhone. iCloud won't import a single vCard larger than 256 KB, photo and text together.

How do I import a VCF file on Android?

Google's steps for its Contacts app are: open the Contacts app, tap 'Organize' at the bottom, then 'Import from file', pick the account to save the contacts in if you have more than one, and select the VCF file. Starting from the Contacts app avoids the problem of a downloaded file opening in some other app. If your phone uses a different contacts app, its menu names will differ; you can also import the file at contacts.google.com on a computer and let it sync to the phone.

Why won't Google Contacts import my VCF file?

Google's help 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. Split a big list into smaller files, check that the file name ends in .vcf, and check that it starts with the line BEGIN:VCARD when opened as text. Google also caps storage at 20 MB with photos not included, and each contact at 128 KB, 1,024 characters per field except Notes, and 500 fields.

Can Outlook import a VCF file with lots of contacts?

Not in one step, going by Microsoft's help. Classic Outlook adds vCards one at a time with 'Add to Outlook Contacts' and 'Save & Close', and Microsoft's import steps for new Outlook and Outlook.com use a CSV file. Microsoft's route for a .vcf holding many contacts is to import it into the Contacts folder in Windows File Explorer, export it from there as a CSV file, then import that CSV into Outlook through 'People' and 'Import contacts'. Microsoft recommends UTF-8 encoding for the CSV so names display correctly.

Why does my VCF file open as text starting with BEGIN:VCARD?

That is what a vCard looks like inside: a plain text file whose first line is BEGIN:VCARD, followed by the version and the contact's details. It means the file opened in a text viewer instead of a contacts app, not that it is broken. Import it from the contacts side instead: Mail or icloud.com/contacts for an iPhone, 'Organize' then 'Import from file' in the Android Contacts app, or 'Import' at contacts.google.com.

Why did my VCF file only import one contact?

Either the file only holds one contact, because the sender exported a single selected contact, or the app you used adds vCards one at a time, as classic Outlook does. Open the file as text and count the lines that say BEGIN:VCARD; each one starts a separate contact. If there are many, import the file at icloud.com/contacts, where Apple says each person becomes a separate entry, or at contacts.google.com.

Written by

OneSol Team

Michael Carter writes the OneSol blog, which covers the problems small businesses and creators run into when they sell online: a link that has to hold everything, a checkout that pays the seller directly, a form that people actually finish.

Run all of this from one link.

Free to start — no card required.