Kentico.Xperience.Contacts.Importer 1.0.0-prerelease-2

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of Kentico.Xperience.Contacts.Importer.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package Kentico.Xperience.Contacts.Importer --version 1.0.0-prerelease-2
                    


                    

                
NuGet\Install-Package Kentico.Xperience.Contacts.Importer -Version 1.0.0-prerelease-2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Kentico.Xperience.Contacts.Importer" Version="1.0.0-prerelease-2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Kentico.Xperience.Contacts.Importer" Version="1.0.0-prerelease-2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Kentico.Xperience.Contacts.Importer" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Kentico.Xperience.Contacts.Importer --version 1.0.0-prerelease-2
                    


                    

                
#r "nuget: Kentico.Xperience.Contacts.Importer, 1.0.0-prerelease-2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Kentico.Xperience.Contacts.Importer@1.0.0-prerelease-2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Kentico.Xperience.Contacts.Importer&version=1.0.0-prerelease-2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Kentico.Xperience.Contacts.Importer&version=1.0.0-prerelease-2&prerelease
                    


                            Install as a Cake Tool

Xperience by Kentico Contacts Importer

Kentico Labs

CI: Build and Test

NuGet Package

About The Project

Enables bulk importing of Contacts into an Xperience by Kentico solution using a .csv file.

View of the Import Upload dashboard

Getting Started

Prerequisites

Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Contacts.Importer

Add to your application dependencies

builder.Services.AddKentico();
// ... other registrations
services.AddContactsImport();

Add to your middleware pipeline

app.InitKentico();
// ... other registrations
app.UseContactsImport();

Usage

  1. open contact importer application <br> ContactImporterApplication
  2. select file
  3. select mode
    1. Delete - this mode will delete contact by ContactGUID (CSV shall contain column with ContactGUID header)
    2. Insert (skip existing) - this mode will import contacts (CSV shall contain column with ContactGUID)
  4. "Assign to contact group" - all contact (existing included) will be assigned to specified group
  5. Delimiter - delimiter used for CSV (common are ;, ,, \\t, ..)
  6. "Batch size" - size of batch used for database operation, for instances with limited resources this value should not exeed 5000, lower than 100 is not reccomended.
  7. Click "Send file" button

Depends on resources available to application, but degraded application performance is expected during import.

Notes:

  • do not close window with progress, file is uploaded from that window.
  • do not manipulate file during import, close all applications write access to file (or lock)

Supported CSV columns

Column .NET Type Required
ContactGUID Guid yes
ContactCreated DateTime yes
ContactFirstName string no
ContactLastName string no
ContactEmail string no
ContactAddress1 string no
ContactMiddleName string no

In the CSV file, define the first row as a header containing the names of the individual columns. Header validation is performed during the file upload. See example file Contact Sample.

For correct functionality, please make sure to add a newline at the end of the CSV file.

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

Kentico Labs

This project has Kentico Labs limited support.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-prerelease-4 83 1/30/2026
1.0.0-prerelease-2 299 6/23/2025
1.0.0-prerelease-1 176 8/22/2023

https://github.com/Kentico/xperience-by-kentico-contacts-importer/releases