For the complete documentation index, see llms.txt. This page is also available as Markdown.

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. HTML files can be previewed from the file detail page, and CSV or TSV files can be reviewed as tables.

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.

Uploading a file with the same name as an existing file creates a new version of that file.

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.

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

JSON files can be used as data sources for Dashboard widgets. From the file detail page, you can also export a JSON file as an Excel spreadsheet.

HTML files can be previewed directly from the file detail page. CSV and TSV files can also be previewed there as tables, and they appear with a spreadsheet icon in the file list.

Video files can be referenced from chat and workflows, and the AI Assistant can inspect their content with the Analyze video tool. Video analysis is available when the Google provider is enabled for your organization.

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.

Viewing and searching files

Screenshot of the file list view
File list view
  • 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.

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.

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.

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

Last updated