> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/resources-context/files.md).

# Files

This article explains the **Files** feature in **Resources**. In **Files**, you can upload and manage workspace files such as specifications, design documents, images, PDFs, videos, JSON data files, HTML files, and Office documents. Files linked from Google Drive also appear alongside uploaded files in the project file list. Uploaded text-based files such as Markdown, text, and JSON are indexed by the AI and referenced when the AI Assistant or workflows run. Images, PDFs, videos, Office files, and linked Google Drive files can also be selected from chat, workflows, and Spaces. Markdown files open in a readable document view, HTML files can be previewed directly, CSV or TSV files can be reviewed as tables, and PDFs and videos can be previewed from the file detail page.

## Uploading files

1. On the workspace page, select **Resources**.
2. Select the **Files** tab.
3. Click **Upload files**.
4. Choose files in one of the following ways.
   * **Select files**: Select individual files to upload.
   * **Select folder**: Upload all files in a folder at once.
   * Drag and drop files into the dialog.
5. Optionally, set a **Label** for the file.
6. Click **Upload**.

{% hint style="info" %}
Uploading a file with the same name as an existing file creates a new version of that file.
{% endhint %}

{% hint style="info" %}
If you add Google Drive files with the file picker and it keeps asking you to sign in, allow third-party cookies for google.com and try again. The picker runs inside an embedded Google frame.
{% endhint %}

Space Files uses the same add flow: upload new files, or link files that already exist in the workspace or come from Google Drive.

## Supported file formats

| File type       | Extension                                                                  | Max size |
| --------------- | -------------------------------------------------------------------------- | -------- |
| Markdown / Text | .md / .markdown / .txt                                                     | 20 MB    |
| JSON            | .json                                                                      | 20 MB    |
| HTML            | .html / .htm                                                               | 20 MB    |
| Image           | .jpg / .jpeg / .png                                                        | 10 MB    |
| PDF             | .pdf                                                                       | 50 MB    |
| Video           | .mp4 / .webm / .mov / .avi                                                 | 200 MB   |
| Office          | .doc / .docx / .docm / .xls / .xlsx / .xlsm / .xlsb / .ppt / .pptx / .pptm | 20 MB    |

{% hint style="info" %}
JSON files can be used as data sources for [**Dashboard**](/dashboard/dashboard.md) widgets. From the file detail page, you can also export a JSON file as an Excel spreadsheet.
{% endhint %}

{% hint style="info" %}
Markdown files open in a readable document view on the file detail page. HTML files can also be previewed there directly, and CSV and TSV files appear as tables. PDFs scale to the viewer width, which makes oversized pages easier to inspect.
{% endhint %}

{% hint style="info" %}
Video files can be referenced from chat and workflows, and the AI Assistant can inspect their content with the **Analyze video** tool. Supported videos such as MP4 files also play directly on the file detail page. Video analysis is available when the Google provider is enabled for your organization.
{% endhint %}

{% hint style="info" %}
Linked Google Drive files appear in the same file browsers used by chat, workflow prompts, and Space Files. Linked Google Sheets are added as Google Drive files; if a sheet was shared as editable, agents can update it, otherwise it stays read-only.
{% endhint %}

## Viewing and searching files

<figure><img src="/files/4xNcCXr7NKiTg3U3BLjs" alt="Screenshot of the file list view"><figcaption><p>File list view</p></figcaption></figure>

* Switch between **List** view and **Grid** view from the top-right of the screen.
* Search by file name from the search box.
* Switch between **Current folder** and **All files** to search only the current folder or the whole workspace.
* Click **Labels** to filter the list by one or more labels.

Each file shows items such as the file type icon, file name, label, indexing status, file size, file format, updated date and time, and uploader. When you open a CSV or TSV file, the file detail page shows a table preview.

In Markdown and text file previews, select text or use the button beside a paragraph to start a comment thread. Use the comments panel on the file details page to browse threads and replies, and look for markers beside commented sections in the preview. If the original text was edited or can no longer be found, the thread shows that status.

## Working with files

From each file's menu, you can perform actions such as the following.

* **View version history**
* **Upload a new version**
* **Rename a version**
* **Restore a previous version**
* **Move the file to another folder**
* **Edit labels**
* **Reindex** text-based files
* **Download**
* **Download as Excel** for JSON files
* **Delete** the file

In version history, you can review who created each version. Versions generated by workflows also show the workflow name and run number, and you can open the related workflow execution from the file detail page. If a workflow saves a file without choosing a destination folder, Genesis stores it in that workflow's **Artifacts** folder by default.

{% hint style="warning" %}
Reindex is supported only for indexed text-based files (Markdown, text, and JSON).
{% endhint %}

## Managing folders

Use the folder tree on the left side of the screen to organize files by folder.

* **Create a folder**: Click **New folder**.
* **Move a folder**: Drag and drop it, or move it from the folder menu.
* **Download a folder**: Download it as a ZIP file from the folder menu.
* **Delete a folder**: Delete it from the folder menu.

{% hint style="warning" %}
Deleting a folder also deletes all files in that folder. This action cannot be undone.
{% endhint %}

## Using bulk actions

Select one or more files from the list to use bulk actions.

* **Add labels**
* **Move**
* **Download** selected files as one ZIP archive
* **Delete**
* **Clear selection**