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

# File Connector (CSV · JSON · Excel)

> Upload CSV, JSON, or Excel files and register them as a data source.

## Overview

The file connector registers CSV, JSON, or Excel files as a data source.
CSV and JSON are parsed directly in the browser, and Excel workbooks are parsed as well.
Direct upload supports files **up to 10MB**, and the original file is kept as the stored source on registration.

<Info>
  This screen is available to **Manager and above** (owner, manager) only. Menu visibility `manage`.
</Info>

## Steps by format

The file wizard steps change dynamically by format.

<Tabs>
  <Tab title="CSV">
    Data view · filter → Field mapping → Register
  </Tab>

  <Tab title="Excel">
    **Sheet · region** → Data view · filter → Field mapping → Register

    Select a sheet, then drag from the start cell to the end cell to define the data region (a rectangle). If you don't, the whole sheet is used.
  </Tab>

  <Tab title="JSON">
    **Select key** → Data view · filter → Field mapping → Register

    Drill into the `json_path` to choose the target location. Choosing an **array** moves to the data view; choosing a **single object** maps it as one record.
  </Tab>
</Tabs>

## Data view · filter

<Steps>
  <Step title="Upload file">
    Drag or click to select a file (single file, up to 10MB).
  </Step>

  <Step title="Select header row">
    Pick the header row that becomes the column names, from among the first 6 rows. If there is no header, click **"No header"** and name the columns directly in the table.
  </Step>

  <Step title="Add filters (optional)">
    Add filters so only matching rows are used. Multiple conditions are combined with AND.
  </Step>

  <Step title="Edit columns">
    Review the top-100-row preview, edit column names, and toggle which columns to include or exclude.
  </Step>
</Steps>

You then complete the **Field mapping** and **Register** steps of the [shared wizard](/en/agent/data-sources#the-shared-4-step-wizard).

## Stored source · security

<Note>
  The source file is kept as the stored source, and only the settings (columns, types, filters, mapping) are saved.
  Data is not copied — it is derived by applying these settings at read time.
</Note>

<Warning>
  Editing a data source keeps the original file unchanged; only the settings change.
</Warning>