Import or upload contacts in Front


You can quickly import a large number of contacts into Front using a .csv file, without the need to manually add your contacts one by one! You can even upload their groups, description, and Twitter, in addition to basic phone and email contact information. 

Another method for uploading contacts is to use our contact API:

Preparing your file

File formatting

Column headings

Column headings and naming conventions are critical for a successful import. The file may only contain the fields listed below (in any order):

  • name
  • email
  • phone
  • link
  • group
  • twitter
  • description

Important to know

  • You can include more than one of each field with the number appended: email2, email3, phone2, phone3, etc. You can add a contact to more than one group by listing them in group, group2, group3, etc. Name and description can only have single fields. 
  • The name column must contain the full name. First Name and Last Name cannot be divided in separate columns.
  • Include the country code (like +1 for USA) in any phone numbers for consistency
  • Extra columns and rows must be deleted, including blank columns and rows.
  • You cannot import custom contact fields through a .csv file upload. You may do so with our API (


Below is an example of a .csv file we can upload:


We have created a .csv template to help get you started: 

Click here for template

Import your contacts

Step 1

Click into your Contact Manager in the bottom left corner (the notebook icon).

Step 2

Select your private contacts (My Contacts) or a team contacts space where you want to import contacts. The contacts space you have selected will determine where your contacts are uploaded.


Step 3

Click the dropdown arrow next to the person icon and choose the second option Import to [location name]. To add a contact one at a time, just click Add contact and skip the remaining steps.


Step 4

Click the Choose file button and select the CSV file you want to import.


Step 6

Click Import CSV to start importing your file. If your CSV is correctly formatted, you’ll see a confirmation in green text.

Step 7

Imported contacts will be automatically put in a contact group based on the date (Format: -YYYY-MM-DD). This is an easy way to access your contacts from a single import all at once, but you can delete this group if you don’t need to following the steps below. Deleting the group will NOT delete the contacts; it will just remove that group label from the contact.

If you listed any new group names in your .csv, those groups will also be created for those contacts. Otherwise, you’ll find your contacts in your specified groups. 

Errors you might see

Contact imports require specific formatting to ensure you can use your contacts correctly in Front! If you hit an error, please check the following: 

1. Your CSV formatting for these common issues below and how to fix:

We display

How to fix

Missing headings in first row

We cannot detect a header row. Check to see if you have an extra empty row and check that your first row contains field names.

File type not in .csv format

We only support .csv files. Convert your file to a .csv format.

Maximum rows 3000

We only support a maximum of 3000 rows per file (not including the header). You can always split large .csv files into smaller ones.

2. The generated .csv error file. When you open the .csv file, it will display a column that indicates the row-related errors. Please see an example error log file below along with common error types and how fix them below:


We display

How to fix

Invalid column heading

There are columns we don’t recognize (could be typo or totally new fields) or columns we don’t support multiple of (name#, description#, team#). If you wish to bring in custom columns, you may do so with our API. Please reference the following for additional details: 

Name, email, or phone must be included

You’re missing values in critical fields: 'Name', 'Email', or 'Phone' for certain rows. Double-check and remove those rows or fill them out.

Invalid email

A value in the Email column is not properly formatted (<text>@<text>.<text>).

Invalid Twitter handle

A value in the Twitter column is not properly formatted (@name between 1 and 15 characters).

Invalid phone number

Please ensure that your phone number is in the format: +1-999-999-9999.

More row columns than header columns

You have more columns in that row than in the header row. 

Contact groups

Contact groups are any easy way to create lists of contacts to email at once or to use in rules. Click the + icon to create a new contact group in your private or team contacts.

Contact groups can be renamed or deleted by hovering on a contact, clicking the options menu, then Rename or Delete. Deleting a group does not remove contacts from your contact manager. It just removes the grouping, so you can still access these contacts in the global contact view (click My Contacts or Team Name).

Updating contacts with a new upload

If you upload a new .csv that may have some of the same contacts that are already in your contact manager, Front will scan for duplicates automatically based on an existing phone number or email address. If there is a match in phone or email, then Front will only replace or update the new fields in your new .csv.

19replies Oldest first
  • Oldest first
  • Newest first
  • Active threads
  • Popular
  • I need to know if there is a way to fetch custom field of contact from front app...Sorry this question is not related to this thread..could not find a better platform to ask

    Reply Like
  • Hello, is there a way I can view analytics on which countries emails are coming from?

    Reply Like
  • Brooke Hahn At this time, this isn't something that Front analytics includes. However, if you figure out a way to tag each conversation with the Country name, then you can pull analytics on those specific tags.

    Reply Like
  • Is there any particular reason why we can't just import a CSV into FrontApp ourselves..?

    Reply Like 1
  • Allie Huang We haven't built this capability yet, but we hope to in the future.

    Reply Like
  • If we send a CSV for import, will it update existing customers?

    Reply Like
  • Grant Andrew Yes, it will.

    Reply Like
  • Cori Morris based on phone number, or does the update require an email address? How do we prevent and manage duplicates?

    Reply Like
  • Tim Berman It does not require an email address and duplicates will not occur. If we import contacts with the same name but different email address from what's already in your Contact Manager, the new imported information will override what's already there.

    Reply Like 1
  • Cori Morris I have dupes from Intercom. Need to be able to associate more than one Intercom cookie with a user as sometimes, they visit from home and work, or on more than one device from home. Some contact via SMS, as well.

    Reply Like
  • Tim Berman You can have multiple phone numbers per contact. On the .csv, your would just need phone2, phone3, etc.

    Reply Like
  • Can 'description' be a number string? 

    Reply Like
  • Chris Morris Yes!

    Reply Like
  • what an epic fail! - this is basic stuff, importing your contacts into a mail app!

    Reply Like
  • Nicholas Saunders , it is definitely something that needs to be addressed. In the meantime, they just launched the Piesync integration, which allows you to sync in all your contacts from tons of tools, real-time. Beats manual uploads! 

    Reply Like
  • Have you been able to implement Excel uploads of contacts yet?

    Reply Like
  • Hi Chris ! We hope to work on this in the coming months and make this feature available soon!

    Reply Like
  • What happens if I upload a CVS with a lot of rows and a lot of them match contacts that are already in our contact book? 

    Is there a way to display the old vs new contact and allow for us to merge or overwrite on a row-by-row basis? 

    (I guess i answered my own question by doing a small test... FYI to everyone else... importing overwrites whatever you already had if there was an existing contact already with the same info) 

    Reply Like 2
  • Cori Morris hello! Any chance analytics based on customer's country has been a new feature released since I last enquired 12 months ago? 🤞

    Reply Like
Like Follow
  • 2 wk agoLast active
  • 19Replies
  • 9615Views
  • 12 Following