For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

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. In the workspace's left sidebar, 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.

When some files in an upload fail, the result identifies each failed file and its reason. If no files are uploaded, the dialog remains open so you can correct the issue and try again.

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

You can also upload files with extensions that are not listed. Files recognized as UTF-8 text are treated as text files and support preview, indexing, and AI references. Files that cannot be recognized as text are stored as binary files: you can download them, but you cannot preview or reindex them.

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.

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. Office documents such as Word, Excel, and PowerPoint files can also be previewed there, and PDFs scale to the viewer width, which makes oversized pages easier to inspect.

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.

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. Select a file in the list to open it in a panel on the right and review it without leaving the list. You can edit and save Markdown and JSON in the panel; other file types are read-only. Open the full file detail page from the panel when needed.

When you open a CSV or TSV file, the file detail page shows a table preview, and Word, Excel, and PowerPoint files can also be previewed from the same page. In an Excel preview, review cell notes and threaded comments with their authors, replies, timestamps, and resolved state.

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.

The file creator receives a notification when someone else adds a new comment. People who have commented in a thread receive notifications for new replies. Select a notification to open its thread; notifications through the displayed comment are marked as read.

When you start a comment, the selected passage remains highlighted while you compose it, and the thread preview shows the passage with the conversation. Opening the comments panel keeps the file viewer in place.

Working with files

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

  • View version history

  • Upload a new version

  • Rename the file

  • 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

Rename a file from its row menu or the pencil beside its title on the file detail page. Its ID, folder, versions, labels, and comments stay the same. You cannot change the file extension, and a name already used in the same folder is unavailable.

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.

For editable files, a compact control group at the top-right of the document brings the edit, preview, and save controls together.

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