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

# Upload File

> Upload files to S3 or other cloud storage integrations

Uploads files generated by upstream nodes (e.g., Export to CSV) to a connected S3 storage integration. Use it to archive reports, deliver data exports, or store generated files.

## Configuration

| Setting              | Description                                                                             |
| -------------------- | --------------------------------------------------------------------------------------- |
| **Integration**      | Your connected S3 integration                                                           |
| **Destination Path** | Target path in S3 - supports **Mentions** for dynamic paths (e.g., `reports/{{date}}/`) |
| **Attachments**      | Files from upstream nodes to upload                                                     |
| **Title**            | A human-readable description of the action                                              |

Each attachment specifies:

| Setting          | Description                              |
| ---------------- | ---------------------------------------- |
| **Display Name** | Human-readable name for the file         |
| **Field Name**   | The field containing the file data       |
| **Node ID**      | The upstream node that produced the file |
| **MIME Type**    | File content type (e.g., `text/csv`)     |

## How It Works

<Steps>
  <Step title="Add a file-producing node upstream">
    Place an [Export to CSV](/guide/nodes/actions/export-csv-node) node before this one to generate the file.
  </Step>

  <Step title="Configure the destination">
    Set the S3 path where the file should be uploaded. Use **Mentions** for dynamic paths.
  </Step>

  <Step title="Select attachments">
    Choose which upstream file outputs to upload.
  </Step>
</Steps>

## Output

The file is uploaded to the specified S3 path when the Agent runs. The upload is logged as a task.

## Example

Archive weekly reports to S3:

1. **Export to CSV** → generate a weekly account report
2. **Upload File** → upload to `s3://reports/weekly/accounts-{{date}}.csv`

## Best Practices

* Use dynamic paths with **Mentions** to organize files by date, region, or category
* Pair with [Export to CSV](/guide/nodes/actions/export-csv-node) for the most common use case
* Verify S3 permissions are correctly configured on the integration

## Related Nodes

* **[Export to CSV](/guide/nodes/actions/export-csv-node)** - generates the CSV file to upload
* **[Private Export](/guide/nodes/actions/private-export-node)** - exports to BonData's internal storage instead of S3