Skip to Content

CSV File Splitter


The CSV File Splitter plugin splits an incoming CSV file into one or more output files.

The default behavior is to write each record of the incoming file to a separate output file. By defining one or more primary keys you can group the incoming records, so that all records with the same primary key values are written to the same output file.

This plugin can be associated only with private agent groups and is not available on the Jitterbit cloud agent groups.


Plugins provided by Jitterbit are deprecated. See Deprecation and support in Plugins.

Download and add the plugin

The CSV File Splitter plugin must be downloaded at the link provided below and added to the organization (see Add new plugins in Customizations > Plug-ins).

Associate the plugin with an agent group

The CSV File Splitter plugin must be associated with a private agent group to make the plugin available on all agents in the group (see Associate agent groups in Customizations > Plug-ins).

Set variables and use the plugin in a project

Refer to these topics for information about using plugins in a project:

The CSV File Splitter plugin uses these variables:

Name Type Required Description
Jitterbit.CsvFileSplitter.Delimiter String Optional The field delimiter. The default value is ','.
Jitterbit.CsvFileSplitter.Qualifier String Optional The value qualifier. The default value is '"'.
Jitterbit.CsvFileSplitter.PrimaryKeys String Optional

Defines the field(s) to use as primary key(s) when splitting up the input file.

If defined, all records of the input file having the same primary key value(s) will be written to the same output file. If defined, this value should be a comma-separated list of field indices, the first field having index 1.

For example, if the incoming file has 3 fields: "order_id, order_date, comment", and you want all records with the same order ID to be written to the same output file, the value of this variable should be "1". If you want to use the order date as a primary key as well you should set this data element to "1, 2".