--- title: "CloudNine Analyst: Managing and Importing Actors in Bulk" description: Importing and Creating Actors in Bulk --- [Skip to content](https://kb.cloudnine.com/managing-and-importing-actors-in-bulk#main-content) English Show submenu for translations [Contact us](https://kb.cloudnine.com/kb-tickets/new?hsLang=en) ![CloudNine](https://kb.cloudnine.com/hs-fs/hubfs/1%20-%20CloudNine%20MARKETING/1%20-%20LOGOS/CloudNine%20Logos/CloudNine_Transparent_Low%20Res.png?width=250&height=94&name=CloudNine_Transparent_Low%20Res.png) Open main navigation Close main navigation - English Show submenu for translations - [Contact us](https://kb.cloudnine.com/kb-tickets/new) - [Go to cloudnine.com](https://cloudnine.com/) [Go to cloudnine.com](https://cloudnine.com/) Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Help Center](https://kb.cloudnine.com/?hsLang=en) 2. [CloudNine Analyst](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en) 3. [Import](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#import) # CloudNine Analyst: Managing and Importing Actors in Bulk ## Importing and Creating Actors in Bulk ### Available Contact Information When you have multiple forms of metadata that you would like to have tied to specific individuals ("Actors") within CloudNine Analyst. CloudNine Analyst allows the matching of data to many different identifiers, which then associated each data point to that specific Actor throughout the platform. To manage this, it is best to keep a report with these contacts and the following information: 1. Email Addresses 2. Phone Numbers 3. Social Media and/or Screen Names 4. Device Serial Numbers 5. Financial Accounts Identifiers (they can be truncated or encoded - these are also stored as encrypted values) 6. Computer User Names 7. PII\* Note: The only required field is the Last Name. If you only have the first name, you can always use the first name only in the Last Name fields and can always update the actor profile with additional information.   Once you have this list, a load file in CSV, DAT, Pipe, or Tab-delimited format can be easily loaded into ESI Analyst within a specified project.    You have two options for importing actor data: **Import Actors (First Time) OR Actor Overlay.**   ### Important Overlay Information If using an Overlay with importing Actors that are already in the system will take precedence over existing actors rather than the deduplication of those actors. Only import NEW actors to the project or perform an overlay with additional account information. If updating records with an overlay, you will need to provide the corresponding Actor ID as one of your columns, otherwise, records cannot be updated. If an Actor ID is provided that is not in the system, the record will be skipped.  **To obtain the Actor ID values for your existing Actors see** [**Export Actor List**](https://kb.cloudnine.com/exporting-actor-list?hsLang=en) ### Import Actors - First-Time Import To import a list of Actors, navigate to the “Project Options” menu and expand “import to Project” -\> “Components” -\> “Actors” ![](https://kb.cloudnine.com/hubfs/Knowledge%20Base%20Import/DocsDisplay-Apr-07-2022-12-18-16-96-AM.png)   This will present you with the following form: ![](https://kb.cloudnine.com/hubfs/Knowledge%20Base%20Import/DocsDisplay-Apr-07-2022-12-18-16-30-AM.png) ### Multi-Value Fields For multi-value fields in your load file, (eg: multiple emails, phone numbers etc. for the same Actor in the SAME cell), separate them with a semicolon (“;” – do not use quotes). For example: johnsmith@outlook.com; jsmith@corporation.com     This applies to ALL multi-value fields. Each email will be associated with the Actor specified, the same applies to financial accounts, phone numbers, etc. For further information about Imports, see our “Importing Metadata” section and make sure to read the “Important Import Instructions” section. Once you have your load file uploaded, you can map the fields:   ![](https://kb.cloudnine.com/hubfs/Knowledge%20Base%20Import/DocsDisplay-Apr-07-2022-12-18-15-43-AM.png) **If you do not select at least one field to be mapped to your load file values, only the Actor will be created and no data will be associated with that Actor!**    ### **Actor Metadata Import Field Types** The currently supported Actor metadata fields are as follows: - First Name - Not Required, Single Value - Last Name - Required, Single Value - Role (primary, secondary, tertiary, or other) - Not Required, will default to "other" in none supplied - Notes - Not Required, Multi-Value separated by semicolon ";" - Email Addresses - Not Required, Multi-Value separated by semicolon ";" - Phone Numbers - Not Required, Multi-Value separated by semicolon ";" - Screen Names - Not Required, Multi-Value separated by semicolon ";" - Devices (serial numbers, or IMEI) - Not Required, Multi-Value separated by semicolon ";" - Financial Accounts (account numbers) - Not Required, Multi-Value separated by semicolon ";" - Computer User Names - Not Required, Multi-Value separated by semicolon ";" - PII - Not Required, Multi-Value separated by semicolon ";" - Date of Birth (DOB)\* - Social Security Number (SSN)\* - International Mobile Subscriber Identity (IMSI) \*currently in development Warning: The actor name NEEDS an associated "Not-Required" field like a phone number, email address, screen name etc.     Actor matching works much the same as your phone's contact list. Once an identifier is input into an Actor profile that data is matched to the records in the system based upon its metadata type (e.g. phone numbers -\> phone calls, twitter id-\> twitter direct messages). Now everywhere it finds a match, the Actor will be associated to that message, activity or otherwise, depending on the metadata type and the correlating matching information input into the Actor's profile.    - [CloudNine Training Videos](https://kb.cloudnine.com/cloudnine-training-videos?hsLang=en#main-content) - [CloudNine Videos by Product](https://kb.cloudnine.com/cloudnine-training-videos?hsLang=en#cloudnine-videos-by-product) - [CloudNine Review](https://kb.cloudnine.com/cloudnine-review?hsLang=en#main-content) - [CloudNine Review Video Library](https://kb.cloudnine.com/cloudnine-review?hsLang=en#cloudnine-review-video-library) - [Section 1: Getting Started](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-1-getting-started) - [Getting Started: My Projects](https://kb.cloudnine.com/cloudnine-review?hsLang=en#getting-started-my-projects) - [Section 2: Understanding Different Views](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-2-understanding-different-views) - [Section 3: Searching](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-3-searching) - [Section 3A. Smart Filters](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-3a-smart-filters) - [3b: Search Term Lists](https://kb.cloudnine.com/cloudnine-review?hsLang=en#3b-search-term-lists) - [Section 4: Working with Documents](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-4-working-with-documents) - [Generating Images](https://kb.cloudnine.com/cloudnine-review?hsLang=en#generating-images) - [Automated Redaction](https://kb.cloudnine.com/cloudnine-review?hsLang=en#automated-redaction) - [Exporting/Producing](https://kb.cloudnine.com/cloudnine-review?hsLang=en#exporting-producing) - [Section 5: Administrative Functions](https://kb.cloudnine.com/cloudnine-review?hsLang=en#section-5-administrative-functions) - [Reporting](https://kb.cloudnine.com/cloudnine-review?hsLang=en#reporting) - [Frequently Asked Questions and Issues](https://kb.cloudnine.com/cloudnine-review?hsLang=en#frequently-asked-questions-and-issues) - [Cloud Connector](https://kb.cloudnine.com/cloudnine-review?hsLang=en#cloud-connector) - [EULA](https://kb.cloudnine.com/cloudnine-review?hsLang=en#eula) - [CloudNine Discovery Portal](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#main-content) - [CloudNine Discovery Portal Video Library](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#cloudnine-discovery-portal-video-library) - [Getting Started](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#getting-started) - [File System Workflows](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#file-system-workflows) - [Data Transfer Workflows](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#data-transfer-workflows) - [LAW Bridge](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#law-bridge) - [Global Monitoring Console](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#global-monitoring-console) - [Advanced Features & Troubleshooting](https://kb.cloudnine.com/cloudnine-discovery-portal?hsLang=en#advanced-features-troubleshooting) - [LAW](https://kb.cloudnine.com/law?hsLang=en#main-content) - [CloudNine LAW Video Library](https://kb.cloudnine.com/law?hsLang=en#cloudnine-law-video-library) - [CloudNine LAW: Did You Know?](https://kb.cloudnine.com/law?hsLang=en#cloudnine-law-did-you-know) - [Installation and Setup](https://kb.cloudnine.com/law?hsLang=en#installation-and-setup) - [Print Queue Management](https://kb.cloudnine.com/law?hsLang=en#print-queue-management) - [Turbo Import](https://kb.cloudnine.com/law?hsLang=en#turbo-import) - [ED Loader](https://kb.cloudnine.com/law?hsLang=en#ed-loader) - [Errors](https://kb.cloudnine.com/law?hsLang=en#errors) - [Email](https://kb.cloudnine.com/law?hsLang=en#email) - [Endorse](https://kb.cloudnine.com/law?hsLang=en#endorse) - [Document Numbering](https://kb.cloudnine.com/law?hsLang=en#document-numbering) - [Annotations](https://kb.cloudnine.com/law?hsLang=en#annotations) - [Image Conversion](https://kb.cloudnine.com/law?hsLang=en#image-conversion) - [Near Dupe](https://kb.cloudnine.com/law?hsLang=en#near-dupe) - [SQL](https://kb.cloudnine.com/law?hsLang=en#sql) - [Batch Printing HTML](https://kb.cloudnine.com/law?hsLang=en#batch-printing-html) - [DataSent](https://kb.cloudnine.com/law?hsLang=en#datasent) - [Filter and Search](https://kb.cloudnine.com/law?hsLang=en#filter-and-search) - [Administration](https://kb.cloudnine.com/law?hsLang=en#administration) - [Explore](https://kb.cloudnine.com/explore?hsLang=en#main-content) - [CloudNine Explore Video Library](https://kb.cloudnine.com/explore?hsLang=en#cloudnine-explore-video-library) - [Managing Cases](https://kb.cloudnine.com/explore?hsLang=en#managing-cases) - [Importing](https://kb.cloudnine.com/explore?hsLang=en#importing) - [Searching](https://kb.cloudnine.com/explore?hsLang=en#searching) - [Exporting](https://kb.cloudnine.com/explore?hsLang=en#exporting) - [Concordance](https://kb.cloudnine.com/concordance?hsLang=en#main-content) - [Searching](https://kb.cloudnine.com/concordance?hsLang=en#searching) - [eDocs](https://kb.cloudnine.com/concordance?hsLang=en#edocs) - [Email](https://kb.cloudnine.com/concordance?hsLang=en#email) - [Other](https://kb.cloudnine.com/concordance?hsLang=en#other) - [Exporting](https://kb.cloudnine.com/concordance?hsLang=en#exporting) - [Proof of Concept](https://kb.cloudnine.com/concordance?hsLang=en#proof-of-concept) - [Concordance Desktop](https://kb.cloudnine.com/concordance-desktop?hsLang=en#main-content) - [Email Database](https://kb.cloudnine.com/concordance-desktop?hsLang=en#email-database) - [CloudNine Analyst](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#main-content) - [CloudNine Analyst Video Library](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#cloudnine-analyst-video-library) - [FAQ](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#faq) - [Known Issues and Behavior](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#known-issues-and-behavior) - [Account](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#account) - [Projects](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#projects) - [Import](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#import) - [Export](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#export) - [Machine Translation](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#machine-translation) - [Reports](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#reports) - [Investigations](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#investigations) - [ESIA Desktop](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#esia-desktop) - [ESIA Sync](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#esia-sync) - [Administration](https://kb.cloudnine.com/cloudnine-analyst?hsLang=en#administration) - [On Premise Software Q&A](https://kb.cloudnine.com/on-premise-software-qa?hsLang=en#main-content) - [On Premise Software](https://kb.cloudnine.com/on-premise-software-qa?hsLang=en#on-premise-software) - [EULA](https://kb.cloudnine.com/on-premise-software-qa?hsLang=en#eula) [![CloudNine](https://kb.cloudnine.com/hs-fs/hubfs/1%20-%20CloudNine%20MARKETING/1%20-%20LOGOS/CloudNine%20Logos/CloudNine_Transparent_Low%20Res.png?width=250&height=94&name=CloudNine_Transparent_Low%20Res.png "CloudNine")](http://www.cloudnine.com) 12848 Queensbury Lane, Suite 208 | Houston, TX  77024 | 713-999-4280 | [info@cloudnine.com](mailto:info@cloudnine.com) Copyright © 2026, CloudNine