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

# 2. Upload files

> Upload the reference documents your knowledge base and agent will use

Numbers alone rarely answer a business question. In this part you upload the documents that explain them -- definitions, policies, playbooks -- into a folder in **Files**. In the next part you build a knowledge base from this folder.

## Before you start

* You completed [1. Connect data](/tutorial/01-connect-data).
* The documents are on your computer. 

## 1. Open Files

Click **Files** on the left navigation rail. The page has three tabs:

| Tab | What it holds |
| - | - |
| **Workspace** | Files shared with everyone in the workspace |
| **Personal** | Your own files |
| **Outputs** | Files that agents produce. Read-only. |

Stay on the **Workspace** tab, so the whole team -- and the knowledge base you build next -- can use the documents.

## 2. Create a folder

1. Click **New folder**.
2. Enter a folder name and click **Create**. 
3. Click the folder to open it.

## 3. Upload the documents

Choose one of these:

* Click **Upload** and select the files.
* Click **Upload folder** and select a folder from your computer.
* Drag files or folders onto the list.

Each file can be up to 100 MiB by default; your administrator can change this limit.

## 4. Check the files

Click a file to open it in the preview pane. Files supports previews of Markdown, CSV and TSV, images and SVG, PDF, HTML, Excel (`.xlsx`) and PowerPoint (`.pptx`). Use the **Preview** and **Source** toggle to switch between the rendered view and the raw content.

<Tip>
  To move a file, drag it onto a folder or onto a breadcrumb. Deleted files go to **Recently deleted**, where you can restore them if the workspace keeps a trash.
</Tip>

<Note>
  A CSV, TSV or Parquet file in Files can also be a **Data** source: in **Data**, click **Connect source** and choose **Workspace files**. Queries read the file as it is now, with no copy. See [Use files](/files/use).
</Note>

## What you built

* A folder of reference documents on the **Workspace** tab of Files, ready to become a knowledge base.

Learn more in [Files overview](/files/overview) and [Use files](/files/use).

<CardGroup cols={2}>
  <Card title="Previous: Connect data" icon="arrow-left" href="/tutorial/01-connect-data">
    Connect a database and publish an analytic model.
  </Card>

  <Card title="Next: Build a knowledge base" icon="arrow-right" href="/tutorial/03-build-context">
    Turn the documents into a versioned knowledge base.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.