Importing data

Format columns in your file

Before you import your data, you’ll need to format each column in your file to get the best results when you import.

Before you start

  • The fields Kinde requires are email, first name, last name, id, and email verified. These fields are necessary for personalization, segmentation, or other features.
  • Clearly label each column in your import file. For example, for the column named “Email,” you’ll know to choose the Email field type.
  • You can arrange the columns in the order of email, first_name, last_name, id, email_verified.

Email address

You must include an email address column in your import file and only one email for each contact. Make sure you are aware of anything that could cause syntax errors, like missing information, unsupported characters, and extra spaces before or after an address.


There is a maximum limit of 255 bytes of information in text fields. The information clips if you exceed the limit. In many alphabets, this is equal to 255 characters. Some alphabets or symbolic characters, like emojis, use more than one byte of information per character, so it isn’t always a one-to-one ratio.

Text Sample

Use text fields for:

  • first name and last name
  • numbers without comma separators

Download a sample import file

If you need help, try our sample import file as a starting point. The sample file contains columns for an import that includes email address, first name, last name, id, email verified state.

Download the sample CSV file, and replace the sample data with your subscriber data. Follow the format guidelines for different types of information, to update your Kinde users accurately.

Sample file

Click the link below to download the sample CSV import file. For best results, open the file in a spreadsheet program like Microsoft Excel or Google Sheets.

Sample CSV Import File

You can update the file with your users information and Save it.

Note: The data contained in the sample import file is not actual contact data. It is for informational purposes only. Replace the sample information before you import.

Importing users

You can import data from a CSV text file into Kinde.

To import data, you’ll need to:

  1. Navigate to the admin area home page.
  2. Click Users in the navigation menu on the left.
  3. Click Add users at the top right.

Add manually

When you open Add users, you can add your users manually. Enter the First name and Last name, as well as the Email address, then Save.

Import users

Importing users is a simple way to migrate your users. Before importing, make sure you format your CSV data.

To import users:

  1. Click the Import users option.
  2. Click Choose file. Your Files window opens.
  3. Select the CSV file you wish to import and click Open.

If you have existing data elsewhere, it’s important to get it into Kinde. You want to make sure that you do this right. We’ll help you do that. Email our team at and we’ll be happy to help you through the process.

Get more support

Help center

Start here - our help center has everything you need to get started and answer many commonly asked questions.

Visit our help center

Talk to us

If you can’t find what you’re looking for in our help center - email our team. We’d love to hear from you.

Contact support
Talk to us