---
title: File
description: Upload and download files.
canonical: 'https://lightning.ai/docs/cli/stable/command-details/file'
---
# File {#file}

Upload and download files.

**Usage:**

```console
lightning file [OPTIONS] COMMAND [ARGS]...
```

## Commands {#file-commands}

| Command | Description |
| --- | --- |
| [`download`](#file-download) | Download a file from a Studio or Teamspace drive file. |
| [`upload`](#file-upload) | Upload a file to a Studio. |

## lightning file download {#file-download}

Download a file from a Studio or Teamspace drive file.

**Usage:**

```console
lightning file download [OPTIONS] PATH
```

### Arguments {#file-download-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `PATH` | `text` | yes | Remote file path to download. |

### Options {#file-download-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--studio` | `TEXT` | no | — | The name of the studio to download from. Will show a menu with user’s owned studios for selection if not specified. If provided, should be in the form of <TEAMSPACE-NAME>/<STUDIO-NAME> where the names are case-sensitive. The teamspace and studio names can be regular expressions to match, a menu filtered studios will be shown for final selection. |
| `--teamspace` | `TEXT` | no | — | The teamspace the file is part of. Should be of format <OWNER>/<TEAMSPACE\_NAME>. |
| `--local-path`, `--local_path` | `DIRECTORY` | no | `'.'` | The path to the directory you want to download the file to. |

## lightning file upload {#file-upload}

Upload a file to a Studio.

**Usage:**

```console
lightning file upload [OPTIONS] PATH
```

### Arguments {#file-upload-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `PATH` | `path` | yes | Local file path to upload. |

### Options {#file-upload-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--studio` | `TEXT` | no | — | The name of the studio to upload to. Will show a menu for selection if not specified. If provided, should be in the form of <TEAMSPACE-NAME>/<STUDIO-NAME> |
| `--remote-path`, `--remote_path` | `TEXT` | no | — | The path where the uploaded file should appear on your Studio. Has to be within your Studio’s home directory and will be relative to that. If not specified, will use the name of the file you want to upload and place it in your home directory. |

---

**Navigation**

- Parent: [Command details](/docs/cli/2026.11.04/command-details.md)