> ## Documentation Index
> Fetch the complete documentation index at: https://help.csvbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Analytics

> Track how users move through the CSVbox importer, from opening the widget to a successful import, to find drop-offs and errors.

Import Analytics gives you visibility into how users interact with the CSVbox importer, from opening the widget to completing a successful import. Use it to identify drop-offs, understand errors, and improve your data import experience.

<Note>
  This feature is available on **Pro plans and above**.
</Note>

## What is Import Analytics?

Import Analytics tracks each importer session and shows how users move through the import flow:

* File upload
* Header selection
* Column mapping
* Data validation
* Final submission

You can use this data to understand where users struggle and optimize your importer configuration.

## What can you track?

### Import funnel

See how many users reach each step of the import process:

* Importer Opened
* File Selected
* File Parsed
* Header Selected
* Mapping Completed
* Validation Completed
* Submit Succeeded

This helps you quickly identify where users drop off.

### Completion rate

Measure how many users successfully complete the import compared to those who start it.

### Drop-offs

Understand where users abandon the process:

* Before selecting a file
* During header selection
* During mapping
* After validation

This helps pinpoint friction points in your flow.

### Time taken per step

Analyze how long users spend on each step:

* Time to select file
* Time to select header
* Time to complete mapping
* Time for validation
* Total time to complete import

### Error insights

Identify the most common issues users face:

* File parsing errors
* Header selection issues
* Mapping errors
* Validation failures
* Destination/API errors

### Session logs

View individual import sessions with details such as:

* Start time
* Final outcome (success, failed, incomplete)
* Last step reached
* Number of rows processed
* Error counts
* Total time taken

This is useful for debugging specific user issues.

## How to access Import Analytics

<Steps>
  <Step title="Open the dashboard">
    Go to your CSVbox dashboard.
  </Step>

  <Step title="Select your sheet">
    Select the sheet you want to analyze.
  </Step>

  <Step title="Open the Analytics tab">
    Open the **Analytics** tab.
  </Step>
</Steps>

You can filter data by date range to analyze recent or historical imports.

## Privacy and data handling

Import Analytics is designed to be privacy-safe.

Analytics **does not store**:

* Uploaded files
* Row data or cell values

It only tracks:

* Step-level events
* Counts and durations
* Error categories and codes

## How to use Import Analytics effectively

### Improve onboarding

If many users drop off early, consider:

* Simplifying instructions
* Providing sample files
* Improving file format guidance

### Optimize header selection

If users spend too long selecting headers:

* Ensure clean file templates
* Improve header row detection
* Add instructions for users

### Fix mapping issues

If mapping drop-offs are high:

* Use clearer column names
* Reduce required fields where possible
* Enable better defaults

### Reduce validation failures

If validation errors are common:

* Review validation rules
* Provide better error messages
* Offer clearer data requirements

### Debug failed imports

Use session logs to:

* Inspect failed submissions
* Identify API/destination issues
* Reproduce and fix problems quickly

## Notes

* Analytics data is aggregated per sheet.
* Sessions are tracked automatically, with no setup required.
* Abandoned sessions are detected after a period of inactivity.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.