How to Use HubSpot Quick Import for Contacts
Importing contacts into Hubspot efficiently is essential when you are migrating data, launching campaigns, or consolidating lists. This step-by-step guide explains how to use the quick import tool to bring new contacts into your CRM with minimal friction and fewer errors.
The instructions below are based on the official product documentation and walk you through preparing your file, running a quick import, mapping properties, and reviewing results so your data stays clean and organized.
What the HubSpot Quick Import Tool Does
The quick import tool in HubSpot lets you upload a simple file of contacts and create or update records in bulk. It is designed for smaller, straightforward imports where you do not need complex matching rules or multiple objects.
With the quick import option you can:
- Add new contact records from a CSV, XLS, or XLSX file.
- Update existing contacts using email or a unique contact ID.
- Map columns in your file to standard or custom contact properties.
- See a quick summary of how many records were created or updated.
This method is ideal when you have a clean file of basic contact data such as names, email addresses, phone numbers, and lifecycle information.
Before You Start: Prepare Your File for HubSpot
Before running a quick import into HubSpot, you should prepare your spreadsheet or CSV to avoid common formatting issues and failed rows.
Basic file requirements for HubSpot
- Use one header row only; each column should have a clear title.
- Place one contact per row under the headers.
- Save the file as .csv, .xls, or .xlsx.
- Remove formulas and keep values only.
- Make sure character encoding is UTF-8 if possible.
Recommended columns for clean contact imports
You do not need to include every possible field, but having these columns makes your import into HubSpot more reliable:
- Email (recommended unique identifier)
- First Name
- Last Name
- Phone Number
- Company Name
- Lifecycle Stage
Check that your header names are meaningful; you will map these to properties during the quick import process.
How to Start a Quick Import in HubSpot
Once your file is ready, you can begin the import process from your contacts dashboard in HubSpot.
Step 1: Open the import tool
- Sign in to your account.
- Navigate to Contacts > Contacts in the main navigation.
- Click the Import button, usually located near the upper right of the contact table.
- Select the option for a quick import of contacts.
The exact labels in the interface may change slightly over time, but you will see an option that clearly indicates a fast or simple contact import.
Step 2: Choose your import file
- Select File from computer when prompted.
- Click to browse or drag and drop your CSV, XLS, or XLSX file.
- Confirm that you are importing Contacts as the object type.
- Continue to the field mapping screen.
If you see a preview of your header row and first few contacts, verify that the data appears in the correct columns before moving on.
Mapping Fields to HubSpot Contact Properties
The mapping stage tells HubSpot how to store the data in your file. Each file column must be matched to a contact property.
How to map columns correctly in HubSpot
- For each column shown, choose a matching Contact property from the dropdown list.
- If the correct property already exists, select it (for example, Email, First name, Phone number).
- If no appropriate property exists, create a new contact property with the correct field type.
- Review any warnings about incompatible formats or missing identifiers.
At least one column should map to a unique identifier, such as the email property, to ensure updates are applied to the correct contact records.
Tips for consistent property mapping in HubSpot
- Match text-based fields to single-line text or dropdown properties.
- Use date-type properties for dates so reporting and automation work properly.
- Align phone number formats (including country codes) before importing.
- Ensure values used for lifecycle stages or lead status match allowed values in your account.
Reviewing and Completing Your HubSpot Import
Before creating or updating records, the tool will provide a quick summary of the contacts that will be imported.
Step 3: Confirm import details in HubSpot
- Check the total number of rows that will be imported.
- Review counts for contacts that will be created versus updated.
- Note any rows flagged as errors or skipped so you can fix them later.
- Optionally, name the import so you can identify it in the history view.
When everything looks correct, click the button to Start import. Processing time depends on how many contacts are in your file, but a small import is usually completed in a short time.
Step 4: View import results in HubSpot
- After processing, go back to the Imports area.
- Locate your quick import by its name and completion status.
- Open the details to see created records, updated records, and any errors.
- If the tool offers a downloadable error file, export it and review which rows failed and why.
Use this feedback to correct your original spreadsheet and rerun a new import only for the rows that failed, instead of repeating the full file.
Common Contact Import Issues in HubSpot
Even with quick import, a few common data issues can cause individual rows to fail or produce unexpected results.
- Missing email or unique ID: Without an identifier, the system may not know whether to create or update a contact.
- Invalid email formats: Addresses without an
@symbol or domain can be rejected. - Mismatched property types: For example, text in a number-type property can generate errors.
- Unsupported date formats: Use clear, consistent formats such as
YYYY-MM-DDwhen possible.
If you need the most up-to-date details about how quick import works, including interface screenshots and limitations, refer directly to the official documentation on the HubSpot Knowledge Base: Import contacts with quick import in HubSpot.
Best Practices for Maintaining Data Quality in HubSpot
Once your contacts are imported, maintaining clean data will help with segmentation, automation, and reporting.
- Standardize naming conventions for properties before importing.
- Use validation rules on critical contact properties wherever possible.
- Schedule regular reviews of your contact database to merge duplicates.
- Document your import process so your whole team follows the same steps.
If you want help designing a scalable import strategy, building property structures, or integrating multiple data sources with your CRM, you can work with a specialized consulting partner like Consultevo to optimize your setup.
Next Steps After a Successful HubSpot Import
After the quick import completes successfully, your contacts are ready to be used in lists, workflows, and campaigns.
- Create active lists based on properties you imported, such as lifecycle stage or region.
- Enroll new contacts in welcome sequences or onboarding workflows.
- Use custom views in the contacts dashboard to review recently imported data.
- Run a small spot-check by opening a few records to confirm that key properties, like email and phone number, were mapped correctly.
By following the steps in this guide, you can reliably import contacts with the quick import tool, minimize data issues, and keep your contact records in good shape for future sales and marketing operations.
Need Help With Hubspot?
If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.
“`
