How to Import Contacts into GoHighLevel from a CSV File
Step-by-step guide to importing contacts into GoHighLevel with a CSV file: preparing the sheet, mapping columns, avoiding duplicates and fixing import errors.

Disclosure: some links in this article are affiliate links. If you sign up through them, Otseiword earns a commission from HighLevel at no extra cost to you. It does not change what we recommend.
Quick answer
To import contacts into GoHighLevel, save your list as a CSV with a header row and at least a name, email or phone number on every row. Then go to Contacts, click Import Contacts, upload the file, choose whether to update existing contacts or create and update, map each column to the right field and confirm. Progress and errors show up under Bulk Actions.
Before you start
- Plan needed
- All plans (Starter, Unlimited and Founder). Only users with admin access can import.
- Where to find it
- Contacts > Import Contacts
- Level
- Beginner
Series: Contacts and pipeline · part 1
Almost everyone arrives at GoHighLevel with a customer list stored somewhere else: a spreadsheet, another CRM or contacts exported from a phone. Bringing that list in is the first step to using your pipeline, WhatsApp and automations with people who already know you. This tutorial shows how to do it without making a mess of your database.
If you’re new to the platform, start with our complete GoHighLevel guide.
Prepare your spreadsheet
The import only accepts CSV files. In Excel or Google Sheets, use “Save as” or “Download” and choose CSV. Before saving, check these points:
| Rule | How to get it right |
|---|---|
| One tab only | Delete other tabs or copy the list into a new file |
| Header in the first row | Column names in row 1, with no blank row above |
| At least one identifier per row | Every contact needs a name, email or phone number |
| Clean phone numbers | No spaces, dashes, brackets or letters |
| No duplicates | Remove repeated rows before importing |
| File size | Up to 30 MB; split larger lists |
If you’re unsure about column names, download the template with the Download Sample File button inside the import and paste your data into it. Only import contacts who agreed to hear from your business. Outside the US, local privacy laws such as the GDPR in Europe also apply to the lists you upload.
Step by step
- Open the import. In the sub-account menu, go to Contacts and click Import Contacts.
- Choose what to import. Select Contacts (or opportunities, or both) and click Next.
- Upload the file. Click Upload File and choose the CSV you prepared.
- Choose how to import. Pick between updating existing contacts only or creating and updating. If in doubt, use create and update.
- Map columns to fields. For each column in your sheet, choose the matching GoHighLevel field. If a column has no field, create a custom field or tick the option not to import unmapped columns.
- Organize the new contacts. Before you finish, you can tag them all, create a smart list with them or add them to a workflow.
- Confirm and track. Tick the confirmation box, finish and follow the progress under Bulk Actions.
The tag in step 6 is what helps most later. With a tag like “imported-november”, you find those contacts in one click and can send a message to just them, for example on WhatsApp. Our guide to GoHighLevel with WhatsApp covers how to connect that channel.
Things that save you rework
- A “DND” column blocks everything. If your sheet has a do-not-disturb column, the import marks the contact as DND on every channel. To block a single channel, use tags and a workflow afterwards.
- One note per contact. The import accepts one note per contact, up to 5,000 characters.
- Empty cells don’t have to erase anything. When updating contacts, the option not to update empty values stops a blank cell from wiping data already in the system.
- Several emails and phones. The system accepts more than one and stores the extras as secondary.
- Workflows will fire. If you add the contacts to a workflow in step 6, it starts running for all of them. Check the message first so you don’t send the wrong thing to your whole list.
If something goes wrong
Open Bulk Actions, click Show Stats and check the error tab. You can download the list of rows that failed. Fix only those rows in your sheet and import them again. The most common error is a phone number with characters that aren’t digits.
Next step
With your contacts in, the next step is creating custom fields for the information that’s specific to your business. If you don’t have an account yet, start the GoHighLevel trial and import your list during the trial. Our 30-day free trial guide explains how the longer trial works.
Frequently asked questions
What is the maximum file size for a GoHighLevel import?
HighLevel's documentation says 30 MB in one place and 50 MB in another. To be safe, keep files under 30 MB and split larger lists into parts.
Does GoHighLevel create duplicate contacts when importing?
By default, the system looks for an existing contact by email first and then by phone, and merges the data when it finds a match. HighLevel still recommends removing duplicates from your sheet before importing.
Can I import contacts and opportunities at the same time?
Yes. At the start of the import you choose contacts, opportunities or both. When a contact and an opportunity are on the same row, the system links them automatically.
What happens if some rows fail?
Failed rows appear under Bulk Actions, in the error tab, with a file you can download. Fix only those rows and import them again, without repeating the whole list.



