Files is the account-level file workspace. Upload, search, preview, rename, index, and delete files, and check how much storage they use.
Where to find it#
Click Files in the main sidebar navigation.
The page has two areas:
- Left sidebar: the file list plus a header and toolbar. The header holds the title, the collapse button, search, and upload (
+). The toolbar holds Select all, Filter, and Sort; after you select files it switches to Vectorize and Delete. The Storage panel sits at the bottom. - Right pane: the header for the selected file, then the Preview and Extract tabs.
With no file selected, the right pane shows File workspace and asks you to select a file.
Upload files#
- Click
+in the file list header. - Pick one or more files.
- The latest uploaded file is selected and shown on the right.
You can also attach files from a chat. Files uploaded in either place appear here. Uploading the same file again reuses the existing copy and reports Duplicate file detected and reused.
After upload, a file may need processing. Images are usually ready quickly. Documents, spreadsheets, PDFs, and code files can pass through waiting, extraction, OCR, and vectorization.
| Status | What it means |
|---|---|
| Waiting | Uploaded and waiting for the processing queue. |
| Queued | Queued for text extraction. |
| Extracting / OCR running | Text is being extracted; OCR is used for scanned content. |
| Vectorizing | Text extraction is done and the semantic index is being built. |
| Ready | Ready for full-context chat, and for smart retrieval when the index is ready. |
| Image ready | The image can be used in a chat. |
| Processing failed | Processing failed. Download the original, then re-upload or adjust the policy. |
| Index failed | The file works in full-context chat, but smart retrieval indexing failed. |
| No text | No readable text was found, so the file is not indexed. |
| Index update required | The file uses an older vector space and must be vectorized again. |
Hover a status badge to read the full detail, including any error code.
Search files#
- Click the search icon in the header.
- Type part of a file name. The list filters as you type.
Search matches file names in the list. It is not a full-text search of file contents. To ask the model about a file's content, attach it in a chat or use a file that supports smart retrieval.
Filter and sort#
Open Filter and choose one or more types. Choose All to clear the type filter.
| Filter | Covers |
|---|---|
| Images | Image files. |
| Audio | Audio files. |
| Video | Video files. |
| Documents | Text and office documents. |
| Spreadsheets | Spreadsheet files. |
| Presentations | Presentation files. |
| PDF files. | |
| Code | Source and code files. |
Open Sort to order the list by Size, Name, Created time, or Last used. Sort by size when cleaning up storage, by created time for new uploads, and by last used to find recent material.
Preview a file#
- Click a row in the list.
- Read the file name, upload time, detected type, size, and status in the header.
- Switch between the two tabs.
| Tab | Shows |
|---|---|
| Preview | Images, PDF, Word, spreadsheets, audio, video, text, Markdown, and code the browser can open. |
| Extract | The text DEEIX extracted from the file. |
Some files cannot be previewed: unsupported types, password-protected or damaged PDFs, and files still processing. The page explains the reason and suggests downloading the original or waiting. Use More info to open the metadata drawer, which lists ID, category, detected MIME, processing, extract and vector status, vector chunks, size, purpose, timestamps, SHA-256, and any failure reason.
Open or download a file#
Use the header buttons on the right pane. Open loads the file in a new tab and Download saves it. Both are disabled until the preview is ready.
Rename a file#
- Hover a row and open More actions.
- Choose Rename.
- Type the new name and press Enter, or click away to save.
Renaming changes the displayed name only. It does not change the file content, type, processing result, or existing chat messages. Use names that are easy to search, such as Customer A contract final.pdf or Q2 usage details.xlsx.
Delete files#
To delete one file, click the trash icon on its row, or use the delete button in the right header. To delete several:
- Click Select all to select the loaded files, or check individual rows.
- Click Delete in the toolbar.
- Confirm in the dialog.
Deletion cannot be undone. Deleting a file removes it from future chats that would have used it. Check that important conversations and shares no longer need it before you delete.
Vectorize and update indexes#
Files that support manual indexing show a vectorize action in the row menu and the right header. The label is Vectorize, or Update index when the existing index is outdated.
- Select one or more files, or open a single file's menu.
- Choose Vectorize or Update index.
- DEEIX submits the jobs and reports the result.
You can submit up to 100 files at a time. Files that need no processing or are not supported are skipped.
Control smart retrieval per file#
When a file's vector index is ready, its status badge becomes Index ready and the list shows a lightning mark. Click the badge in the header to toggle retrieval.
- Index ready allows the file to participate in smart retrieval.
- Retrieval off excludes it.
The file stays stored either way, and you can turn retrieval back on at any time.
Check storage#
The Storage panel at the bottom of the list shows used space against the quota, or an unlimited state. With a quota, it also shows the used percentage and remaining space.
When space runs low, sort by size, remove large files, clear duplicates, and delete old material that no longer matters. The panel updates after deletion.
Reference: statuses and messages#
| Message | Meaning |
|---|---|
| File uploaded / {count} files uploaded | Upload finished. |
| Duplicate file detected and reused | The file already existed and was linked instead of copied. |
| Some files failed to upload | The toast lists how many succeeded and failed; retry the failed files. |
| File is still processing. Preview will be available later. | Wait and reopen the preview. |
| File processing failed. Preview is unavailable. | Download the original and re-upload, or adjust the policy. |
| Online preview is not supported for this file type. | Download the file instead. |
| This PDF is password protected and cannot be previewed here. | Open the original PDF. |
| You can submit up to 100 files at a time | Reduce the vectorize selection. |
Troubleshooting#
| What you see | What to check |
|---|---|
| No files yet | Click + in the header to upload your first file. |
| No matching files | Clear the search or filter. |
| Failed to load files | Refresh; check that you are signed in. |
| Session expired | Sign in again; viewing, uploading, deleting, and renaming all require a session. |
| Failed to update setting | The retrieval toggle did not save. Try again. |
| A file stays in processing | Wait; large or scanned files take longer. Reopen the preview later. |