Back to blog

How to Upload Contacts to Gmail: Step-by-Step Instructions

How to Upload Contacts to Gmail: Step-by-Step Instructions

Switching to a new email platform or setting up a fresh device can make you realize how annoying it is to copy hundreds of names and numbers manually. Fortunately, Google Contacts provides straightforward tools to let you import all your details at once. If you have your contact list saved in a compatible format, you can complete the process in a few minutes.

This guide explains how to get your list ready and walk through the exact steps to upload contacts to Gmail from both computers and mobile devices.

Preparing Your Contact File for Google

Before you start the import process, your contact information must be saved in a file format that Google understands. Google Contacts supports two formats: CSV (Comma Separated Values) and VCF (Virtual Contact File or vCard).

Depending on where your contacts currently live, you can export them using these methods:

  • Outlook or Yahoo Mail: Log in to your mail dashboard, go to the contacts section, and select the export option. Save the file as a Google-compatible CSV.
  • iCloud (iPhone): Open iCloud.com in a desktop browser, select Contacts, click the gear icon in the bottom-left corner, and choose "Export vCard". This downloads a .vcf file.
  • Android Devices: Open your default Contacts app, navigate to settings or contact management, and look for the export option to create a .vcf file on your device storage.

Step-by-Step Gmail Contacts Upload Process

The easiest way to import contacts to Gmail is through a desktop web browser.

  1. Open Google Contacts: Go to contacts.google.com and sign in using the Google account where you want to store your contacts.
  2. Find the Import Option: In the left sidebar menu, look for the "Import" option.
  3. Select Your File: In the popup window that appears, click the "Select file" button and locate the CSV or VCF file you saved earlier.
  4. Run the Import: Click the "Import" button to start the upload. Google will process your file, and your contacts will appear in the main list.

Google automatically assigns a label like "Imported on [Date]" to these newly added contacts. If you realize you uploaded the wrong list or made a mistake, you can use this label to select and delete all the newly imported entries in one go.

How to Import Contacts to Gmail from a Phone

If you want to sync contacts directly from your mobile device to Google, you don't necessarily need a computer. The approach varies based on your phone's operating system.

On Android, syncing is typically handled automatically. Go to your phone's Settings > Accounts > Google, select your account, and verify that the "Contacts" sync toggle is turned on. Once enabled, any contact you add to your phone is immediately synced to your cloud account.

For iPhone users, if you want your new contacts to save to Google by default, go to Settings > Mail > Accounts. Add your Gmail account if it is not already there, and toggle on the "Contacts" switch. However, if you want to copy your entire existing iCloud contact list over to Gmail, it is cleaner to export your vCard from iCloud.com on a computer and upload it through the Google Contacts web portal.

CSV vs. VCF File Formats

If you are choosing how to export your contacts, this quick comparison table highlights the differences between the two formats:

Feature CSV File VCF (vCard) File
Best Use Case Moving from Outlook, Excel spreadsheets, Yahoo Transferring from iPhone, Android back-ups, macOS
Readability Easy to open and edit in Notepad or Microsoft Excel Formatted as code blocks, hard to edit manually
Profile Pictures Cannot save contact photos Supports embedding profile photos directly
Language Support Can cause character encoding errors with non-English names UTF-8 support ensures names display correctly

Troubleshooting Common Upload Errors

You might run into a few hurdles while attempting a gmail contacts upload. The most frequent issue involves custom CSV files where Google doesn't recognize the column headers. Google expects specific header names like "First Name", "Last Name", and "Email Address". If your import fails, open your CSV file in Excel or Notepad and make sure the very first row contains these standard labels.

Another common problem is broken text formatting. If your CSV file wasn't saved using UTF-8 encoding, special or accented characters might look like garbled symbols. You can resolve this by opening the file in a plain text editor, clicking "Save As", and explicitly choosing "UTF-8" from the encoding dropdown.

If you encounter an error code or file formatting issue and want to ask for help on a forum or share the visual error with a friend, you can quickly share a screenshot of the problem. You can use ImageUpload.app to drag and drop your screenshot and get a clean, shareable image link instantly without creating an account.

Keep in mind that Google Contacts has an import limit of 3,000 contacts per file. If your list is larger than that, split your file into smaller chunks before attempting to upload.


Internal Links

FAQ

What is a Google contacts CSV file template? A contacts CSV is a plain text file containing columns of contact info. If you need a template, the easiest way is to create a single contact manually in Google Contacts, export it as a Google CSV, and open it in Excel. This gives you the exact header names Google needs.

Why are my imported contacts not showing up in my Gmail list? If the upload completed but your list looks empty, try refreshing your browser or clearing your cache. Also, check the "Other Contacts" folder in the left-hand menu. Contacts that do not have enough name or email details often end up there.

Will importing contacts to Gmail delete my old contacts? No. Google Contacts merges the imported file with your existing list. It will not delete your current entries. If Google detects duplicate names, it will prompt you with a suggestion to merge them under a clean card.

How many contacts can I store in Gmail? Google allows you to save up to 25,000 contacts per account. Additionally, there is a total storage limit of 20MB for all contact files combined, which is usually plenty for text-based contact entries.