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

# upload

> Upload a CSV or Excel file as a new dataset

Upload a local CSV or Excel file to Landbase to create a new dataset. The returned dataset ID is used with `match`, `enrich`, and other workflow commands.

## upload

**Usage**

```bash theme={null}
landbase-cli upload <file> [flags]
```

<ParamField path="file" type="string" required>
  Path to a `.csv` or `.xlsx` file to upload.
</ParamField>

**Flags**

| Flag                | Default | Description                              |
| ------------------- | ------- | ---------------------------------------- |
| `--name=<value>`    | —       | Name for the new dataset                 |
| `--no-update-check` | —       | Skip the daily update check              |
| `--verbose`         | —       | Print request/response details to stderr |

**Examples**

```bash theme={null}
# Upload a CSV file
landbase-cli upload ./contacts.csv

# Upload and assign a name
landbase-cli upload ./contacts.csv --name="Q1 Prospects"

# Upload an Excel file
landbase-cli upload ./crm_export.xlsx --name="CRM Export"
```