This page describes the various validation options available inside the importer.

Column Data Types

While creating a sheet you can specify the column to be any of the data types mentioned below. If the incoming CSV data does not match the column data type (and its validation rules), then the user will see a relevant error message identifying what the problem is and how to fix it.


This is the default column data type. It accepts any alphanumeric string. You can provide the Min Length and Max Length parameters to specify the acceptable length of the text data.


This Number column data type accepts integer and float strings only. Additionally, you can provide the Min Value and Max Value parameters to specify the acceptable range of numbers.


The column under validation must be formatted as an email address.


The column under validation must be formatted as a date. You have to select a Date Format from the dropdown list to specify the acceptable format. The default format is 'MM/DD/YYYY'. If your desired format is not found in the list, you can simply provide your custom format using the formatting tokens below.
1 2 ... 11 12
1st 2nd ... 11th 12th
01 02 ... 11 12
Jan Feb ... Nov Dec
January February ... November December
1 2 3 4
1st 2nd 3rd 4th
Day of Month
1 2 ... 30 31
1st 2nd ... 30th 31st
01 02 ... 30 31
Day of Year
1 2 ... 364 365
1st 2nd ... 364th 365th
001 002 ... 364 365
Day of Week
0 1 ... 5 6
0th 1st ... 5th 6th
Su Mo ... Fr Sa
Sun Mon ... Fri Sat
Sunday Monday ... Friday Saturday
Day of Week (Locale)
0 1 ... 5 6
Day of Week (ISO)
1 2 ... 6 7
For example, specifying a token string dddd, MMMM Do YYYY, h:mm:ss will require the date to be in the format Sunday, February 14th 2010, 3:25:50 pm.


The column under validation must be able to be cast as a boolean. Accepted inputs are true, false, TRUE, FALSE, 1, 0, yes, no, y, n, on, off, enabled, and disabled.


The column data must match the given regular expression. You need to specify the Regex and the importer will pattern match it with the incoming data.


The column under validation must be an IP address. You have to select the IP Version.


The column under validation must be a valid URL.

Credit Card

The column under validation must be formatted as a credit card number. Acceptable formats are 5555555555554444, 5555-5555-5555-4444 and 5555 5555 5555 4444.

Phone Number

The column will be validated for phone number formats based on the libphonenumber.js library. You have to select a default country code. If the incoming phone number does not have a country code then this default country code will be used for validation.


With the List data type, you can specify a list of acceptable values. The importer will compare the CSV column data with the list of acceptable values and throw a validation error if there is a mismatch. You can specify a list of acceptable Values and related Display Labels. The importer will match the column data with the list of Display Labels. If the data passes validation then the Values corresponding to the Display Labels will be pushed to the destination. For example say, you configure the List column as shown below:
List Data Type
In this case, the acceptable data in the CSV column will be Small, Medium, and Large. Based on the actual data found in the user CSV, the values s, m or l will be pushed to your data destination. This allows you to accept readable values from your users while pushing data to your system that is in a format it understands.

Dynamic List

This is similar to the List type column above where the importer will validate the column data against a list of values. However, instead of providing a static list of values, with the Dynamic List column type, you can now specify a list of acceptable values in real-time via an API.
The API should return the list of values in the JSON format as shown below.
{"value": "uk", "display_label": "England"},
{"value": "us", "display_label": "United States"},
{"value": "au", "display_label": "Australia"}
For each list item, the value field is mandatory while display_label is optional.
The importer will attach the custom user attributes as query parameters to the Dynamic List API request. csvbox_ prefix will be added to the custom user attribute query parameters. This will help you identify the users/environment and return back a relevant list of values.

Other Validation Options

Column Required

You can check/uncheck the Required checkbox on the Column Settings window. The column data must be present, and not empty if the Required checkbox is ticked.