Import customers or suppliers from email contacts to QuickBooks Online

Learn how to import your customer or supplier contact lists from Outlook, Excel, and Gmail.

Do you have a customer or supplier list that you'd like to bring into QuickBooks Online? We'll show you how to export your list as a spreadsheet from Outlook, Gmail, or Excel. Then we'll show you how to import them directly into QuickBooks.

Things to know before you import contacts from Outlook, Excel, or Gmail

• The file size limit is 2MB or 1000 rows. If you need to import a list larger than that, you'll need to split it up into multiple imports.
• Sub-accounts can't be imported. We recommend changing the sub-accounts into parent accounts before you import. Then you can change them back after the import.
• If the file is imported incorrectly and it needs to be re-imported, your customer or supplier list won't be overwritten, which can create duplicate entries. You'll need to delete the imported customers or suppliers before re-importing, or edit each one individually.
• The entries in the Name field must be unique. A supplier, customer, or employee can't have the same name as another.
• The import only supports one email address. Don't worry, you can add others in QuickBooks later.
• When importing contacts from a spreadsheet (including files exported from Excel, and as a CSV) make sure that:
  • Column headers are in the first row.
  • Contacts are on Sheet1 of the spreadsheet.
  • The spreadsheet doesn't have any formulas, charts, or blank rows.
  • The spreadsheet doesn't have any errors, such as #REF!, #NAME?, #N/A or #VALUE!.
  • Names don't contain colons (:) or quotation marks (").

Export your contacts from Outlook or Gmail

If you have a contact list in Outlook or Gmail, you can export a CSV file of your contacts and import it to QuickBooks.

To import a spreadsheet into QuickBooks, you'll need to format it correctly. Learn more about contact field descriptions and restrictions. Then follow these steps to create your spreadsheet.

1. Create a new spreadsheet in Excel.
2. Make sure you're using Sheet1 of the spreadsheet.
3. Make sure that row 1 of your spreadsheet is filled in like the Spreadsheet Column key below (under the capital letters). For example, label column A, row 1 as Full Name. Label column B, row 1 as Company Name, etc. Also make sure there are no blank cells or other headers at the top of the spreadsheet.
4. Fill in your spreadsheet with your contacts' information. It's ok to leave any information that you don't have as blank. Note: The import maps the contact's address to the billing address field in QuickBooks Online.
5. If you're using Excel, save the spreadsheet as an XLS or an XLSX file and note where you save it.

Verify the exported file

Before you import your contacts, it's important to review the information and make sure everything looks right. If the import has mistakes, it can be a lengthy process to manually correct or remove your imported contacts.

1. Open the CSV or XLSX file you saved and check it for accuracy.
2. Double check that your spreadsheet column titles in row 1 match the sample spreadsheet above.
3. Check the contacts, fill in any missing information, and correct any mistakes.
4. Make sure the file doesn't exceed the 2MB or 1000 row limit. If it does, split it into multiple import files.

Import your contacts

Now that your spreadsheet is accurate, you're ready to import your contacts to QuickBooks Online.

1. Sign in to QuickBooks.
2. Select Settings ⚙. Then select Import Data.
3. Select Customers or Suppliers, depending on which you are importing.
4. Select Browse to upload the file from your computer. Choose the file, and select Open.
5. Select Next.
6. In the Your Field column, select each small arrow ▼ icon. Then, match your field to the corresponding QuickBooks Online field.
7. Select No Match if you have a field that doesn't have a matching column in your spreadsheet.
8. Confirm your contacts. Uncheck any that you don't want to save.
9. If everything looks good, select Import.

Learn more about other types of imports

• Products and Services: Import products and services
• Chart of Accounts: Import a chart of accounts
• Bank transactions: Upload more than 90 days of bank transactions
• Recreating list from another company file: Move your lists to QuickBooks Online