Importing contacts via Excel file

Introduction

Managing a large contact list can be challenging, especially when you have to add Contacts by one to a new database. Artshell simplifies this process by offering two solutions for Contacts importing your Contacts :


    • Concierge Service: Our team of experts will handle the import of large amounts of data for you. Click here to learn more about the Concierge Service.
    • Advanced Import: a tool that lets you import large numbers of Contacts your own by uploading an Excel file directly to the Artshell database.

No matter which method you choose, it’s essential to remember that a well-organized and professional contact list is one of the keys to your organization’s success. So take this opportunity to carefully review the Contacts want Contacts keep in the Contacts section Contacts Artshell:

  • delete those that are no longer active;
  • check that there are no typos in the email addresses (which would otherwise be invalid);
  • Please make sure that your first name, last name, and company name are entered correctly.

The Contacts section Contacts Artshell is closely linked to the Email and Newsletter section, which allows you to send messages to your recipients within the same interface.

This is very convenient, but it also requires some care: for example, if you use personalized greetings like Hello #name or Hello #company, make sure the fields have been filled in accurately. Otherwise, you risk unprofessional results, such as a Hello [empty field] (if the data is missing) or a Hello Tina instead of Hi Antonia, if the contact was saved inaccurately.


In this article, you'll find step-by-step instructions on how to use the advanced import feature.




Step 1: Download and fill out the "Import Contacts Excel) file

Below is an Excel spreadsheet template that you can download and fill out.

Download the Excel template for importing Contacts :

The file is also available for download within the Artshell software from Settings panel ( ), under the heading Import: click Contacts and then Download the Excel template.


Once you've downloaded the file, follow these steps:

Open the file in Excel.

The file consists of a first header row, whose headings must NOT be modified , and a second row containing sample descriptions. The columns in the first header row are color-coded by type of contact information to help you fill out the form.


Tips for filling out the form:
• Notes on columns: Hover over the column headers to view the notes.
• Sample row: You can keep the second sample row while you're filling out the form and delete it only after you've entered your Contacts. This will allow you to refer to the sample descriptions if you have any questions.

  1. Take a moment to review all the columns in the file. If there are any columns you don't need, you can choose to leave them blank or delete them entirely from the file.
  2. Each row in the Excel file corresponds to a record . Fill out one row of information for each contact you want to upload, following the header row. If a field applies only to some Contacts, you can leave the cell blank for the others—it will not be imported into their record. Finally, some fields require a specific format to be imported correctly.
Click here to view more detailed instructions on how to fill out the form.

Name text 
Last name text
Company text
Contact type text
Location text
Tags text - separate with commas
Email description text - presence of default options
Email  text and number
Phone description text - presence of default options
Phone number
Name and address text
Go text and number
City text
Zip code number
Province/Region/State text
Country text, from the Nations sheet
Link description text - presence of default options
Link URL
Company name text
Billing method text and number
Billing ZIP code number
Billing City text
Province/Region/State of billing text
Billing country text, from the Nations sheet
VAT ID number
Tax ID number text and number
Billing email text and number
Nationality number, from sheet, nationality
Date of birth number
Month and date of birth number
Year of birth number
Notes text and number

  1. Save the file in XLSX format and rename it as you like. Do not save the file in any other format, as the system cannot process it.

Important! Before uploading the file to Artshell, make sure to:

  • DO NOT CHANGE the header row titles. Do not translate them, do not change their font, and do not add any additional columns. Doing so will prevent the system from correctly mapping Excel columns to record fields. As mentioned earlier, you can, however, delete one or more columns entirely if you do not need them.
  • DO NOT INCLUDE FORMATTING: If you have copied and pasted data from another Excel file into the file you want to import, make sure the content is not formatted ( check that there are no hyperlinks, bold or italic text, colors, etc.). You can use Excel’s “Clear Formatting” command to ensure the file contains no formatting.
  • NO FILTERS HAVE BEEN APPLIED.



Step 2: Import the "Import Contacts Excel) file

Once you’ve prepared your file— making sure it doesn’t contain any filters or formatted elements—it’s time to upload it to Artshell. Follow these steps:

  1. Click the icon at the bottom left.
  2. Select the " Import" option.
  3. Select Contacts.
  4. Click the " Browse " button and select the file you want to import from your computer.
  5. Click the Import button and wait for the data to load. The time required may vary depending on the number of Contacts your internet connection.
Please note: By accepting Artshell’s terms and conditions, you have declared that you have the appropriate authorization to manage all the information of Contacts are uploading. 

Once the upload is complete, the system will display a brief summary of the import:

  • How many Contacts imported:

    That is, the number of Contacts successfully.

  • How many Contacts been merged: 

    That is, the number of Contacts the system has identified as already existing in your Artshell database. In this case, some of the newly uploaded data is merged with record existing record . Learn more in the next section of this article.

  • Errors:

    That is, the number of Contacts were not imported due to errors in the data entry.


If Contacts or errors are detected during the import, a "Download Report" button will appear, allowing you to download an Excel file summarizing the Contacts and any errors.

 



Subsequent imports

You can perform bulk imports via Excel files multiple times in Artshell to expand, supplement, or update your contact list.

During subsequent imports, Artshell checks whether the Contacts the Excel file match records that already exist in the database.

Artshell uses multiple levels of control to ensure Contacts even Contacts an email address—such as records as locations within Artworks events—are handled correctly.


How Artshell recognizes and links Contacts

Artshell applies the following checks, in order of priority:

Primary email (Email 1)

The first criterion isthe primary email address, which is the "Email 1 " field in the Excel file. If the "Email 1" field is filled in, the system checks whether a record with the same primary email address already exists. If so, the data from the Excel file is used to update the existing record .

First Name and Last Name

If the Email 1 field is left blank, the system checks to see if both the First Name and Last Name are present. If there is a record with the same First Name and Last Name, the system updates that record. If there are multiple records the same First Name and Last Name, the oldest record (i.e., the one created first) will be updated.

Company

If neither "Email 1" nor "First Name and Last Name" are filled in, the system uses the "Company" field as the identification criterion. In this case as well, if there are multiple records for the same company, the record is updated.


Tip: Whenever possible, we recommend always using the "Email 1" field as the primary update criterion. For Contacts an email address, it is best to fill in both the "First Name" and "Last Name" fields correctly, rather than relying solely on the "Company" field, which may be less specific and lead to ambiguity.

What happens if there are Contacts ?

If there are duplicates in the database—for example, the same email address associated with multiple records —the system may encounter an ambiguous situation.

In these cases, Artshell follows a set of priorities:

  • If the same email address appears in multiple records, the record which that address is listed as Email 1—that is, as the primary address (the first one, at the top of the record )—is updated;
  • If the same address is entered as Email 1 in multiple records , the record —that is, the one created first— is updated.

However, if the email address is entered in an Excel file in a column other than "Email 1"—for example, "Email 2"—the system may not recognize the contact as already existing and may create a new record.

For this reason, before importing an update, it is important to check for any duplicates and ensure that the address to be used as a reference is entered in the Email 1 column.


If you know there are duplicates in your database, a good approach might be:

  • export Contacts Excel;
  • identify duplicate email addresses, for example by using Excel's conditional formatting;
  • Identify the Contacts and decide which information you want to keep;
  • prepare an initial import file for Contacts , which can be updated more easily;
  • Prepare a separate import file for the duplicates after you have corrected and cleaned them up.



How is data handled during the merger?

When a contact is recognized as already existing, Artshell updates the record based on the data in the Excel file.

Specifically:

  • Fill in the fields in the record that are “empty” with the values from the Excel file.   
  • Tag: adds the tags present in the Excel file that are not already present in the record .    
  • Email, Phone, Addresses: adds any additional email addresses, phone numbers, or addresses found in the Excel file that are not already included in record .    
  • Overwrites the values in Excel that correspond to fields already filled in within the record (with the exception of tags, email addresses, phone numbers, and addresses, which, as we have seen, are added rather than replaced).    

For tags, email addresses, phone numbers, and addresses, Artshell never performs a "subtraction" during import. This means that this information can be added via an Excel file, but it is not removed if it is already present in record .


Contacts update multiple Contacts

If you need to update a large number of Contacts in Artshell, we recommend that you do not manually fill in the fields used for recognition (such as email, first and last name, or company).


You can speed up the process by following these steps:

  1. Select the Contacts want to update or edit;
  2. Export these Contacts Excel;
  3. Copy the entire column (Email1 or Company) from the exported file—if you’re using First Name and Last Name to update the data, you’ll need to copy and paste both of these columns;
  4. Paste the data into the corresponding column in the Excel import file : Email1, or Company, or First Name and Last Name if you are not using an email address;
  5. Fill in only the columns corresponding to the fields you want to update or add;
  6. Upload the updated file using the import feature.

This way, you use data that is already in the system and is accurate, reducing the risk of errors or duplicates and making the update much faster and more efficient.


Please note: If you also use other sections of Artshell, such as Emails and Newsletters, and have linked Contacts Artworks events, we do not recommend completely deleting the Contacts Contacts section Contacts then reimporting them. Doing so may invalidate newsletters that have already been sent, affect the related statistics, and cause malfunctions in other sections.


Conclusions

Importing via Excel is a powerful tool that allows you to quickly and efficiently manage even large numbers of Contacts.

By using Email1 correctly and following the best practices outlined here, you can keep your contact list up to date and organized, minimizing errors and duplicates.

Did this article clear up your question? Thank you for your feedback There was a problem sending your feedback. Please try again later.

Need help? Contact us Contact us