Home/HighLevel/Features/Contacts/HighLevel CSV contact import: step by step guide

CRM and Pipelines

HighLevel CSV contact import: step by step guide

In short

Importing contacts with a CSV file lets you add or update leads, clients or customers in HighLevel. An Admin must run the import, the file must be under 30 MB, contain a single sheet with a header row, and include at least one of name, email or phone. You upload the file, map each column, optionally import opportunities, and monitor the process until it finishes.

AreaContacts · Getting Started with Contacts
Used forReal estate agency, Dental practice, SaaS startup
Setup steps11 steps in 1 task
Last updatedNovember 16, 2026

01Who this is for

  • Founders who need to move an existing client list into the platform quickly, because bulk upload saves manual entry.
  • Marketing teams that run campaigns and require a clean, segmented contact list ready for smart lists and workflows.
  • Sales managers who want to load new opportunities together with contacts to seed the pipeline in one step.

02Importing contacts, explained

The CSV import tool accepts only .csv files. After the file is uploaded you map each column to a standard or custom field in HighLevel. The system checks for existing records based on Contact ID, then Email, then Phone, so updates do not create duplicates. You can also choose to import opportunities at the same time, linking each row to a pipeline stage.

The feature lives on the Contacts page. From there you start the import, select contacts only or contacts plus opportunities, upload the file, set mapping preferences and launch the process. Progress and any errors appear on the Bulk Actions page where you can download an error log.

03How businesses use importing contacts

  • Real estate agency. Upload a CSV of property owners and leads, map the address and phone fields, and tag the imported contacts as "new lead". The agency can then add the contacts to a nurturing workflow that runs daily.
  • Dental practice. Import a list of patients with appointment dates, map the date field, and create a smart list that shows upcoming appointments. The practice can add the contacts to a reminder workflow automatically.
  • SaaS startup. Load a CSV that contains both user details and trial subscription information, select the option to import contacts and opportunities, and map the subscription columns to opportunity fields. The startup gets leads directly into its sales pipeline.

04The numbers and rules that matter

  • File size limit is under 30 MB.
  • At least one required field per row: Name, Email, or Phone.

05Before you start

  • User must have Admin access.
  • CSV file must be under 30 MB, contain a single sheet, and start with a header row.
  • At least one required field, name, email or phone, must be present in each row.

06How to set up and use importing contacts in HighLevel

Import contacts using a CSV file

  1. Navigate to the Contacts tab and click the Import Contacts button.
  2. Choose whether to import only Contacts or both Contacts and Opportunities.
  3. Press Next, then select the CSV file from your computer and indicate if you are adding new contacts or updating existing ones.
  4. Match each column in the file to the corresponding field in HighLevel; check the "Don't update Empty Values" box if you do not want blanks to overwrite existing data.
  5. If you need to import data into custom fields, create those custom fields in HighLevel before completing the import.
  6. Review all field mappings, ensure mandatory fields are covered, and confirm any optional actions such as creating a SmartList, adding to a workflow, or applying tags.
  7. If you wish to import opportunities as well, check both Contacts and Opportunities before proceeding and ensure opportunity columns are present in the CSV.
  8. Start the import by clicking the Import button.
  9. Open the Bulk Actions page to watch the import progress and view statistics.
  10. If errors occur, click the Error tab to download the error log and review details.
  11. When the import finishes, verify that contacts appear in the contact list and that any opportunities are visible in the pipeline.

07What it looks like in HighLevel

08Settings that matter

  • Don't update Empty Values. When selected, fields that are empty in the CSV will not overwrite existing values in the contact record.
  • Allow Duplicate Contacts (Contact Deduplication Preferences). Controls how the system matches incoming rows to existing contacts; it determines whether duplicates are prevented based on Contact ID, Email or Phone.

09Things to know before you rely on it

  • Only CSV (.csv) files are accepted; Excel or Google Sheets are not supported.
  • File size must be smaller than 30 MB; larger files need to be split.
  • The CSV must contain a single sheet and the first row cannot be blank.
  • At least one of Name, Email or Phone is required for each contact row.
  • Headers in the CSV must match existing system fields; mismatched headers will not be imported.
  • Special characters such as spaces, dashes or letters are not allowed in phone numbers.

10How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Importing contacts is a solid way to get large lists into HighLevel quickly.

Skip it if you don’t have Admin rights or a properly formatted CSV.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about importing contacts.

Can I import contacts without an email or phone number?

A contact must have at least one of the following: name, email or phone. Without any of these the record cannot be created.

What if I want to skip some columns in my CSV?

Leave those columns unmapped during the field matching step. Unmapped columns are ignored.

Can I use the import to update existing contacts?

Yes. Choose the update option and the system will match incoming rows to existing contacts in the order Contact ID, Email, then Phone.

Where can I see previous imports?

All past imports are listed on the Bulk Actions page, where you can also view statistics and download error logs.

Do I need to create custom fields before importing data for them?

Custom fields must exist in HighLevel before mapping CSV columns to them. Create the fields first, then run the import.

How are contacts and opportunities linked when they are on the same CSV line?

When both types of data are present, the system automatically maps opportunity columns to the related contact on that row.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.