Get started

CSVJetty documentation

Add CSV importing, automatic column mapping, validation, inline corrections, and callback or webhook delivery to a React application with CSVJetty.

View as Markdown

On this page

Install Quick start How it works Choose delivery Learn the concepts Next steps

CSVJetty gives your application a complete CSV upload workflow: file upload, automatic column matching, validation, inline correction, and delivery of clean records to your application.

Install

BASH

npm install csvjetty

Create an importer in the CSVJetty dashboard and copy its public importer key. The key identifies the column configuration and delivery settings for that importer. Learn more about importers.

Quick start

ImportContacts.jsx

"use client";
import CSVJetty from "csvjetty";
export default function ImportContacts() {  return (    <CSVJetty      importerKey="YOUR_IMPORTER_KEY"      onData={async ({ rows }) => {        console.log(rows);      }}    >      Import contacts    </CSVJetty>  );}

Clicking the button opens CSVJetty inside your app. With callback delivery, the parsed and validated row data is passed to your onData handler.

How it works

Open or download this recording

27-second dashboard preview: upload, mapping and correction. Preview mode does not deliver records to your application.

Your user selects a CSV file.
CSVJetty suggests matches between uploaded headers and your fields.
Required values and configured data types are validated.
The user can correct invalid values before importing.
CSVJetty delivers the resulting records by callback or webhook.

Original CSV files are not stored

CSVJetty never stores the original uploaded CSV file. With callback delivery, imported row data stays in the browser until your application handles it. Webhook delivery temporarily retains payloads for reliable delivery and retries.

For a complete mental model, read How CSVJetty works.

Choose delivery

Callback delivery

Keep imported row data out of CSVJetty. Receive rows directly in your React application and save them through your own authenticated API.

Webhook delivery

Send records server-to-server to an HTTPS endpoint with signed requests, retries, and idempotency keys.

Not sure which path fits? Compare them in Delivery modes.

Learn the concepts

Importers

Understand the reusable configuration behind each import flow.

Column mapping

See how unpredictable source headers become your application's fields.

Validation & corrections

Learn how field rules, corrections, and invalid rows work.

Delivery modes

Compare browser callbacks with signed server-to-server webhooks.

Next steps

Check capabilities and requirements or troubleshoot an integration.

React

Add CSVJetty to a React application and handle imported records.

Next.js

Use CSVJetty with either the App Router or Pages Router.

Configure columns

Define output fields, aliases, types, examples, and custom validation.

Reference

Look up component props, payload fields, callback results, and limits.

React