Skip to main content

Importing Contacts

To make the transition from your prior case management software to Neos even easier, your firm has the option to import contacts.

NOTE: You must have the Import From CSV Special Permission enabled to access the Import option from the Create menu, Browse Cases, Browse Intakes, and Address Book.

To import Contacts:

Click the Import Contact button from the Address Book. (You can also use the Import > Cases/Contacts from CSV option via the Create menu, Browse Cases, and Browse Intakes.)

Select information within each step to move through the process of configuring the CSV file to be imported to Neos. As steps are completed, the solid circles will be updated with a checkmark.

  1. Select Record Type - When Import Contact is selected from the Address Book in Neos, "Contact" will be the default Record Type.

  2. Select Contact Type – Use the dropdown to choose if the contacts are people (Person) or companies (Company). "Person" is the default selection.

  3. Import CSV – Click the Browse hyperlink to open a file browse window where you can select the CSV file to be imported. Due to performance demands, up to 999 records can be imported as contacts into Neos at a time.

Your CSV file must contain fields for Last Name (Person) or Company Name (Company). Refer to Contact Import Mapping for a full list of fields available for importing contacts.

NOTE: Data from your CSV file must be in the proper format. Contents from your CSV file should be validated prior to importing to ensure the data meets all requirements. Refer to Valid Data Formats for Importing Contacts for more details.

Once the file has been selected, the name of the file will be displayed. If you need to select a different file, click on the hyperlink and the file browse window will open.

The fields from the selected CSV file will be displayed in the Map and Validate section. You will need to map the fields from your CSV file to the desired fields in your Neos data.

4. Map and Validate - Along the top, you will see the Neos Fields dropdown from which you can select the appropriate field for each column. Neos Fields can only be used once for each CSV column.

When the mapping has been saved and for subsequent imports, click the Select mapping link to display a list of all saved mapping configurations.

>>TIP: This feature is helpful for firms that get weekly referrals. Advise your firm's third-party to send referrals in the same mapped format each week. Duplicates are automatically checked between your CSV file and Neos at the time of import.

Neos uses set criteria to match a contact from your CSV file to an existing name in your firm's Neos database. Refer to Check for Duplicates – Contact Name Matching for more details.

For an existing mapping profile: Select the mapping profile you wish to use and click the Save button. The saved fields will populate for your current session. Ensure all fields are mapped correctly if you are using a different CSV file for importing.

NOTE: Field Mappings are saved by Record Type. If a different record type is chosen in step 1, any selected mappings will be cleared.

For new Contact field mappings:

  • If the first row from your CSV file contains field names, select the Mark first row as header checkbox, so the first row will be ignored on import. This check box will need to be reselected regardless of saved mapping profiles.

  • If required fields have not been satisfied, red text will display showing the number of fields that are still required. Neos required fields are denoted with "*required" in the Neos Fields dropdown. These warnings may display due to a blank Company Name field or blank Last Name field mapping.

  • Click the Show more rows hyperlink to display the next 5 rows from your CSV file. The first 6 rows will display by default.

Click the Select dropdown above each column in your CSV file and map each field that you wish to be imported. Keep scrolling to the right until all fields have been mapped.

The Neos Fields dropdown contains standard contact fields. Refer to Contact Mapping for a full list of Person and Company fields that can be mapped.

The Neos Fields dropdown will contain options for importing emails, online accounts, phone numbers, and addresses. If your CSV file has fields for two Numbers (Phones) (e.g., Mobile and Fax) or two (Online) Accounts, only one of each type can be imported.

  • The Email field will import emails with a Type of "Personal".

  • The Account field will import online accounts with a Type of "Personal" and Platform of "Website".

  • The Number field will import phone numbers with a Type of "Home".

  • The Address field will import addresses with a Type of "Home".

After the import is complete, return to the desired Contact to add/modify Phones, Emails, Addresses, or Online Accounts.

Use the search in each field to locate the Neos field you wish to map. Simply select the available section to expand and choose the corresponding field.

Once required fields have been satisfied, Neos field configurations can be saved before or after completing the import. Click the Save Mapping Profile button to enter a Name and Description for this mapping profile. Click Save when finished.

Initiate Import

When you have completed your mapping and selected appropriate Neos fields, click the Import button on the bottom right.

If any issues with the data (invalid format or missing data) are detected, an Invalid Data window will display.

  • Click the Import button to proceed with the import process, skipping any erroneous data (the Contact(s) will be imported but this data will NOT be added).

  • Click the Cancel button to abort the import and return to the Import from CSV tab. To clean up the CSV data, you will need to open your file and make the necessary changes.

If duplicate names are detected in your Neos database, a Duplicated Entries window will display. Use the checkboxes to select the names you wish to import to Neos, this will create duplicates of the existing names. Only the names you select will be created as new contacts.

  • Click the Import button to proceed with the import process. Any selected names will be created again.

  • Click the Cancel button to abort the import and return to the Import from CSV tab. You may choose to delete the existing intakes from Neos either before the import or after the import (if duplicates were created).

NOTE: If the selected Contact Type or CSV file has changed, a warning will display.

  • Click the Yes button to lose your mapping selections and continue with your recent changes.

  • Click the No button to keep your mapping selections and abort your recent changes.

The import will run asynchronously and add contacts in batches. This means that you can navigate to another tab in Neos to continue working without affecting the import. You'll see a progress window and be notified when the backup is complete.

Click View Batch to open the Address Book showing the list of contacts with the corresponding batch number. An Advanced Search report can be run for batch numbers.

If at least one contact has been successfully imported, the progress window will show "Complete". The number of failed rows will display in parentheses.

Open the Notifications pane and click the Errors link to view the list of problems that prevented all contacts from being imported.

If no contacts were created during the import, the progress window will show "Invalid Data". This could occur if your CSV file has no data in the required Last Name field.

Click the View Errors link (or the Errors link in Notifications) to open the Invalid Data window, showing the list of problems that prevented all contacts from being imported.

Did this answer your question?