# Quick Upload

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

The **Quick Upload** feature in Gaio DataOS allows you to quickly import files like `.csv` and convert them into structured tables inside your project. With the redesigned interface, which includes two tabs — **Table** and **Columns** — the import process is now more intuitive, secure, and customizable.

***

## How to Use Quick Upload

***

### 1. **Open the Quick Upload Panel**

* On your home bar, select quick upload

<figure><img src="/files/mrO856ZdIRnyhC7nv5Qi" alt="" width="375"><figcaption></figcaption></figure>

***

### 2. **Upload Your File**

* Drag and drop a file into the upload area,\
  or click **Browse Files** to select one from your device.
* Only **one file** can be uploaded per operation.

📌 Supported formats: `.csv`

***

### 3. **Configure Table Details (Table Tab)**

* **Label**:\
  Provide a friendly name to identify the task.
* **Table Name**:\
  Define the name for the new table that will be created in the project.
* **Project**:\
  Confirm or change the target project for the table.
* **Table Discovery** (enabled by default):\
  When enabled, this makes the table available in:
  * **Power Search** (semantic, natural language search)
  * **AI Dashboard** (automatically generated dashboards)

***

### 4. **Adjust Column Settings (Columns Tab)**

After uploading your file, switch to the **Columns** tab to review and configure each column:

* **Data Type**:\
  Adjust the data type for each column (`String`, `Decimal`, `Date`, etc.) to match the contents.
* **Column Name**:\
  Rename columns as needed for clarity and consistency.
* **Date Format (optional)**:\
  For `Date`-type columns, specify the original format from the CSV (e.g., `dd/mm/yyyy`, `yyyy-mm-dd`).
* **Decimal Size**:\
  Set the number of decimal places for numeric fields.
* **Treat Data Warning**:\
  A notification reminds you to review numeric, decimal, and date fields to ensure they are interpreted correctly.

{% hint style="info" %}
Tip: Use the **"Change all to string"** button to quickly convert all fields to text if unsure.
{% endhint %}

***

### 5. **Finalize the Upload**

* After validating all columns and settings, click **Upload** in the bottom-right corner.

Your new table will be created in the selected project and immediately available for use in queries, dashboards, flows, and AI modules.

***

#### Best Practices

* Ensure column names are clear and well-structured.
* Always double-check data types before uploading — especially for dates and numbers.
* Use descriptive table names to make it easier to locate the data later.

***

{% hint style="warning" %}
If you access this task through the studio, you can only upload a new spreadsheet, without advanced settings.
{% endhint %}

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


---

# 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/tasks/etl/quick-upload.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.