AI agents: the content index is at /llms.txt. Every page is also available as Markdown — send the request header Accept: text/markdown, or append .md to the page URL.
Xperience Docs

Cookie consent

We use necessary cookies (opens in a new tab) to run our website and improve your experience while browsing. Additional cookies are only used with your consent. You may revoke your consent on the Cookies Policy (opens in a new tab) page or in your browser at any time.

Configure (opens in a new tab)
  • Documentation
    InstallationUsing the Xperience interfaceDeveloping websitesConfiguring XperienceManaging usersSecuring websitesDeploying websitesManaging website contentMultilingual websitesMacro expressionsExternal utilitiesIntegrating 3rd party systemsCustom developmentE-commerce featuresOn-line marketing featuresRelease notes - Xperience 13Xperience terminology glossary
  • Tutorial
    Using the Xperience interfaceDeveloper tutorialBusiness tutorialResource hub for marketers
  • API Examples
    ConfigurationContent managementDevelopmentE-commerceOn-line marketingSocial media
  • Community Questions & Answers (opens in a new tab)
  • Contact support (opens in a new tab)
  1. Home
  2. On-line marketing features
  3. Managing your on-line marketing features
  4. Contact management
  5. Working with contacts
  6. Importing contacts

Importing contacts


Was this page helpful?

Send us feedback Go back to top

You can import contacts into Xperience from Comma-separated values (CSV)⁠ (opens in a new tab) files.Contact import comes in handy when you need to use contacts from 3rd party systems in Xperience. Typically, you will be able to export contacts to CSV files directly from your CRM. You can also export CSV files from Excel spreadsheets. After importing contacts and adding them to a contact group, you can send them an email. The Kentico Xperience Enterprise edition also allows you to start a marketing automation process or use other On-line marketing functionality.

Limitations and requirements

Please take into account the following requirements and limitations of the import functionality:

  • Only CSV files can be used for import.
  • The input CSV file has to be encoded in UTF-8.
  • The first row of the input file must contain a header with the names of the columns.
  • Only text contact fields are supported. Importing of birthday, gender, country and other such fields is not supported.
  • See an example CSV file.
  • The contact import uses HTML 5 File API functionality, which is supported by the majority of modern browsers.

Importing contacts

Note: The import process overwrites existing contact values.

  1. Open the Contact management application on the Contacts tab.

  2. Click the Import contacts button.

  3. Click the Select a file button.

  4. Select the CSV from which you want to import contacts.

  5. Segment the imported contacts into a contact group by selecting from the following:

    • Create a new contact group
    • Import contacts into an existing contact group
    • Do not segment imported contacts
  6. Map the columns from your file to Xperience contact fieldsby specifying which contact fields represent the specific values in the file:

    • Each value can be represented by one field.

    • You always need to map the Email value. Xperience uses email addresses to identify unique contacts.

    • Labels in gray show names of the columns from the input CSV files (First Name, Last Name and Email). Values under the column names show sample values in each column. The drop-down list under each column allows you to specify which of the contact's fields will be filled with values from this column.

  7. Click the Import contacts button.

    • The import process starts. Please don't leave the page until the Import finished status is shown.
    • Once the process is finished, you can see a confirmation screen showing the result of the import.

See how you can now work with the contacts you just imported.

After the import, the system automatically:

  • Recalculates all the affected Personas, Contact groups, and Scores to keep them up-to-date.
  • Triggers Marketing automation processes that use the 'Contact created' and 'Contact changed' triggers for newly created and updated contacts.

Import finished screen description

Once the import finishes, a summary screen is displayed showing import results.

Each contact from the input file can end up in one of the following categories:

  • Imported – the number of contacts successfully created in the system.
  • Duplicates found and successfully updated – the number of contacts from the input file that already existed in the Xperience database and were successfully updated. Also contains entries that were in the CSV file more than once.
  • Not imported contacts – the number of contacts that weren't created or updated due to an error. You can download a .CSV file containing the contacts that haven't been imported. The file contains an explanation of how you can remedy the situation next to each entry. Afterwards, you can import the file with the remaining contacts.

Related pages

  • Working with contacts
  • Marketing automation
  • Email marketing