Importing contact details

With SALESmanago you can easily import contacts from contact files. Before you start, make sure you have the files prepared More information

You can add more details to contacts than just their email address and name. This additional information can even be used later as details or tags. Imports are easy and quick to do, so if at any point you want to add, update or delete contact information, consider doing an import.

IMPORTANT: USER_ID account owners can also import contacts directly into the system.

IMPORTANT: You can import up to 20 VARIOUS tags and also you can import 16 tags for one email address. 

To import contact details, go to

CDP → Contacts list → Import Contacts→ Import new contacts


  1. Choose a file
  2. Basic data
  3. Additional details
  4. Base segmentation
  5. Advanced
  6. Summary of the import
  7. Import statistics

1.  Choose a file

[1] Import name – enter a name of the import. It makes it easier to find imports and their statistics later.

[2] Drag a file or select a file from your computer – you can add files in two ways.

  • drag and drop files onto the appropriate field
  • click the field and select a file from your computer, then click the Upload.

If you upload a valid file, a green mark will appear over it (see: example)

2. Basic data 

TIP: If you have difficulty using the interface of this panel, hover your mouse cursor over the “Sample Mapping” button.  An animated overlay will appear and show you the basics of using the panel.

[1] Column from the file – a list of all available positions in the imported file. Information used as basic data should be selected and dropped into the “Drag and drop a column” section.

[2] Field on the contact card – choose a place on the contact card where you want the value to be imported:

  • email (required field),
  • full name,
  • phone number,
  • fax,
  • day of birth,
  • street,
  • city,
  • postal code,
  • province,
  • country,
  • external ID,
  • position,
  • department.

[3] Settings – you can make changes to mapping details by clicking the “Settings” button next to them.

[1] Change text:

  • don’t change anything – the imported text will look exactly as in the file.
  • change to UPPER CASE – the imported text will be in CAPITAL LETTERS (e.g. a value swimming would change into SWIMMING on the contact card)
  • change to lower case – the imported text will be in lower case  (e.g. a value sWiMming would change into swimming on the contact card)
  • change to CamelCase – the imported text will start every word with a capital letter (e.g. a value kate rejdych would change into Kate Rejdych on the contact card)

[2] Validation:

  • none – all information from the file will be imported.
  • not empty – only contacts without an empty field will be imported. For example, if you choose ‘not empty validation’ for ‘phone’ only contacts with a phone number will be imported. Contacts without a phone number will not be imported.
  • email – imported information must be structured like an email address e.g.
  • phone – imported information must be structured like a number (only numbers, spaces, hyphens, brackets, full stops and a plus at the beginning count as valid signs, phone numbers should have from 6 to 14 characters.)
  • other – you can choose characters that shouldn’t be imported or set regular expressions.

[3] For existing contacts overwrite even if ‘value’ is empty – use this feature to replace existing details with new details, even if the field is empty.

TIP: If you set a validation for emails and then import, only emails that passed validation will be imported.

3. Additional details

You can choose what data to import onto contact cards as a detail. You can change the name of the detail, but its value will be the same as in the imported file.

[1] Change detail name – here you can change the name of an imported detail. A name entered here will be imported to the system and appear on the contact card.

TIP: Only 16 details per one contact can be imported at once.

4. Base segmentation 

Here you can add tags to imported contacts, or choose a column from the file. This data will be saved on the contact card as tags.

[1] Add tags to all imported contacts – the entered tags will be added to all imported contacts – both new and updated ones.

[2] Add tags only to new contacts – the entered tags will be added only to new contacts. (New contacts are ones which have not been imported to the system yet) This function is useful in regular imports of contacts and can be used to highlight new ones.

[3] Column with tags – choose a column from the file with tags prepared for an import.

TIP: If you are preparing an import and there are two or more tags in one column, open Settings and check the option that allows adding multiple tags.

[4] Separator settings – a separator is a sign or symbol used to separate tags from each other in one field.


  • none – no validation. All information from cells will be imported as a single tag e.g ‘swimming’ and ‘diving’ → tag: [swimming and diving]
  • “,” – tags will be separated with a comma e.g. ‘swimming’, ‘diving’ → tags: [swimming] [diving]
  • “;” – tags will be separated with a semicolon e.g. ‘swimming’; ‘diving’ → tags: [swimming] [diving]
  • other – in this field you can specify a separator of your choice.

TIP: Only 16 tags per contact can be imported at once.

5. Advanced

[1] Contact status – choose which contact status should be assigned to all imported contacts. More information

  • Set only for new contacts – assigns the selected status only to new contacts.

[2] Mark imported contacts as ‘invalid’ – marks email addresses as correct, but permanently excepted from receiving messages.

[3] Change opt-in/out status* – all contacts are imported with an opt-in status by default.

To import contact status information (opt-in/opt-out) add this column to the imported file:


  • The column must contain opt-in in its name (see: example above)
  • For contacts with an opt-in status, enter ‘true’ as a value.
  • For contacts with an opt-out status, enter ‘false’ as a value.

IMPORTANT: While importing contact details there is no possibility of mapping manually opt-in status because it is done automatically. 

[4] Send a detailed report to the account owner and the address in the CC field: sends an email with a report about the import to the main user’s email address. The current user will receive a carbon copy.

[5] Import contacts – click the button to import contacts. Before you do, verify if all fields have been filled in correctly.

6. Summary of the import 

After you start the import, you will be redirected to the summary screen. The import will begin and cannot be interrupted or stopped.

The number of invalid email addresses in the file represents the number of contacts that could be imported because of the wrong structure or limits set during the validation process.

7. Import statistics

After the import is completed, you can see its statistics. To do so, go to CDP → Import Contacts, select your import and click Details.


TIP: If the box is orange and the word DETAILS is invisible it means that the import is still in progress. Details become available after the import is completed.



[1] Records found – the number of contacts found in the imported file.

[2] Number of imported contacts – the number of contacts that were imported during this import.

[3] Number of updated contacts – the number of contacts that have been updated during this import.

[4] Number of invalid contacts – the number of contacts that have not been imported because of wrong structure or failed validation.

[5] Number of duplicate contacts in the file – the number of duplicate emails in the file.

[6] Assigned tags to all imported contacts – a list of tags assigned to all imported contacts.

[7] Assigned tags only to new contacts – a list of tags assigned only to new contacts (contacts which did not exist in the file before the import).


If you need more information about the topic mentioned above, please contact us: +1 800 960 0640