# Files

<figure><img src="/files/T1WTyZvTYfKW8oKuKdVw" alt=""><figcaption></figcaption></figure>

The **Files** panel in Gaio DataOS allows users to upload, organize, and use local files directly within data flows. It’s ideal for working with tabular files (.csv, .xlsx, etc.) for quick analyses, algorithm testing, or even recurring data processes.

***

## What you can do:

### **1. Upload files**

<figure><img src="/files/JtutUGV5q56K08oN202K" alt=""><figcaption></figcaption></figure>

* Go to the left-side **Files** tab (folder with an upload icon).
* Click the **upload** button (cloud with an arrow icon).
* Either drag and drop your files or click **"Browse Files"** to locate them on your device.
* Supported file formats:\
  `.txt`, `.tab`, `.csv`, `.tsv`, `.xls`, `.xlsx`, `.json`, `.parquet`

(You can upload multiple files at once.)

***

### **2. Automatic organization**

Uploaded files are automatically grouped into:

* `inputs` → input files used as sources.
* `outputs` → files generated or exported from the flow.
* `content` → additional files such as text, images, etc.

***

### **3. Use files in the flow**

* After uploading, you can **drag a CSV file into the canvas**.
* This table becomes available as a data source for analysis, transformation, and dashboard building.

***

#### Quick actions for each file

Each file has action icons next to it:

* Information.
* Download file.
* Delete file.

***

#### Best practices

* Name your files clearly for easy identification.
* Use the `outputs` folder to store results of your transformations and analyses.
* Prefer `.csv` files for maximum compatibility with Gaio’s visualization and transformation features.

{% hint style="info" %}
**Large files**&#x20;

Gaio's server has no limitation on file sizes. It is worth paying attention to the fact that the server is full and no longer supports files and especially the domain manager used by the company which may impose a limit on file sizes, for example CloudFlare limits it to 200 MB .
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/tools/files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.