Home/HighLevel/Features/Contacts/HighLevel guide to bulk importing contacts and opportunities via CSV

CRM and Pipelines

HighLevel guide to bulk importing contacts and opportunities via CSV

In short

The CSV import feature lets you add or update many contacts and opportunities at once. You upload a single sheet CSV, match its columns to HighLevel fields, choose create or update actions, and watch the import status. Errors are shown with a downloadable log for correction.

AreaContacts · Bulk Actions
Used forReal estate agency, Dental practice, SaaS startup
Setup steps13 steps in 2 tasks
Last updatedNovember 16, 2026

01Who this is for

  • Admins who need to load large client lists quickly, because the feature handles bulk creation and updates.
  • Sales teams that track opportunities, since both contacts and opportunity records can be imported together.
  • Marketers who want to tag new contacts or add them to workflows during the import process.

02Importing contacts and opportunities, explained

HighLevel provides a bulk CSV import tool for contacts and opportunities. The importer reads a single sheet CSV file, matches each column to a field in the system, and either creates new records, updates existing ones, or does both. You can also decide not to update empty values, keep unmapped columns out of the import, and add tags, smart lists, or workflow enrollments as part of the process.

The import workflow is accessed from either the Contacts tab (Smart Lists > Import Contacts) or the Opportunities tab (top right Import button). After selecting what to import, you upload the CSV, choose the import mode, map columns, review options, and confirm to start. Progress and any errors appear on the Bulk Actions page for contacts and opportunities.

03How businesses use importing contacts and opportunities

  • Real estate agency. The agency prepares a CSV of property leads with names, emails, and phone numbers. Using the import tool, they map these columns, select "Create & Update" to add new leads and refresh existing ones, and tag the imported contacts as "New Lead" for follow up workflows.
  • Dental practice. The practice exports patient appointment data to CSV, includes multiple phone numbers, and imports it. The "Don't update Empty Values" option preserves existing patient notes while adding new contact details and linking opportunities for upcoming procedures.
  • SaaS startup. The startup uploads a CSV of trial sign ups, maps the email and company fields, chooses "Update Only" to refresh trial statuses, and adds the contacts to a smart list for targeted email campaigns.

04The numbers and rules that matter

  • CSV file should be under 30MB.

05Before you start

  • User must have Admin access.
  • CSV file must be in .csv format, under 30 MB, and contain only one sheet.
  • First row must include a header; at least one column must match a system field.
  • Each row needs at least one required identifier: name, email, or phone.

06How to set up and use importing contacts and opportunities in HighLevel

Import contacts and opportunities

  1. Open the Contacts tab or the Opportunities tab and click the Import button.
  2. Select whether to import Contacts, Opportunities, or both, then click Next.
  3. Click Upload File and choose the CSV file from your computer.
  4. Press "Choose how to import contacts/opportunities" and pick Create, Update, or both.
  5. Map each CSV column to the appropriate HighLevel field, ensuring all mandatory fields are mapped.
  6. Check the "Don't update Empty Values" box if existing records should keep their current data when the CSV column is empty.
  7. Leave any columns unmapped and check the box at the bottom to skip importing those fields.
  8. Optionally select to create a Smart List, add contacts to a Workflow, or apply a new Tag during the import.
  9. Mark the mandatory confirmation checkbox for all contacts/opportunities and start the import.

Monitor import status

  1. Navigate to the Contacts and Opportunities Bulk Actions page.
  2. Find your import entry in the list of bulk actions.
  3. Click the "Show Stats" button to view progress and success counts.
  4. Open the Error tab, download the error log, and review details for any failed rows.

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 data in the record.
  • Confirm all contacts/opportunities for import. A required checkbox that must be selected before the import can begin, confirming user intent.

09Things to know before you rely on it

  • CSV files must be smaller than 30 MB; larger files need to be split.
  • Only a single sheet/tab is allowed in the CSV.
  • The first row cannot be blank and must contain column headers.
  • Each row must include at least one required identifier: name, email, or phone.
  • Phone numbers must not contain parentheses or dashes; they should be plain digits.
  • Notes imported via CSV are limited to one note per contact with a maximum of 5000 characters.

10If something goes wrong

  • Duplicate contact or identifier. Remove or combine duplicate rows in the CSV, then re import.
  • Invalid email or phone. Correct the formatting of the email or phone values and retry the affected rows.
  • Missing identifying information. Add a valid name, email, phone, or Contact ID to each row before importing.
  • Invalid field value. Match the value to the correct HighLevel format or option for that field.
  • Owner not found. Use the exact user name or email address of an existing HighLevel user.
  • Contact not found or update failed. Verify the Contact ID, email, or phone matches an existing record, then retry.
  • Partial or bulk action failure. Correct only the rows that failed and re import those rows.
  • Processing error. Review the CSV formatting for issues and retry the import.

11How it connects to the rest of HighLevel

Michael's take

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

I find the bulk CSV import useful for adding many contacts or deals into HighLevel. I start by cleaning the CSV. Remove duplicates, fix phone formats, and make sure each row has a name, email, or phone. Then follow the import steps.

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

Common questions

Common questions about importing contacts and opportunities.

What happens if my CSV file is over 30 MB?

Split the file into smaller sections under 30 MB and import them separately.

Can I import contacts with multiple emails or phone numbers?

Yes. Additional email addresses and phone numbers are stored as secondary fields during the import.

How does HighLevel handle duplicate contacts?

HighLevel searches first by email, then by phone. If a match is found, the existing record is updated instead of creating a duplicate.

Can I update existing contacts via CSV import?

Yes. Choose Update Only or Create & Update during the import.

Why are all my imported contacts set to Do Not Disturb for all channels?

If the CSV includes a DND column, HighLevel applies DND to every communication channel. Use a workflow and tags instead to set DND for specific channels.

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.