> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/search-and-details.md).

# Search, Filters, and File Details

Search for files across spaces in the file library, filter by type, view file details, and move, delete, or download files in bulk.

As your file collection grows, you do not need to remember where each file is stored. The search bar at the top searches all spaces you can access, shows each result's location, and lets you open it with a click.

## Use Case <a href="#use-case" id="use-case"></a>

A customer calls to ask about last quarter's quote. The sales representative only remembers that the filename contains “Quote.” She searches for “Quote” at the top of the file library, and the results show “Q3 Quote.xlsx” with “My Files › A1 Launch Proposal” below it. Clicking the file opens its details on the right, where she clicks <mark style="color:blue;">Download</mark> to attach it for the customer.

***

## Search Across Spaces <a href="#search" id="search"></a>

Enter a keyword in <mark style="color:blue;">Search all visible files</mark> at the top right of the file library, then click the search button. The results list matching files from all spaces you have permission to view. Each result shows its location (space › workspace › folder). Click a filename to open its details.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-ee3ba9e442d64fec672468a280fcfcce5677eb54%2Ffile-library-search.png?alt=media" alt="File library search results for “Quote,” with each file&#x27;s location shown below its name"><figcaption><p>Search results indicate “Across all visible spaces” and show each file's location</p></figcaption></figure>

{% hint style="info" %}
To find workspaces in the current space only, use <mark style="color:blue;">Search file workspaces in this space</mark> above the list.
{% endhint %}

***

## Filter by Type and Switch Views <a href="#filter-and-view" id="filter-and-view"></a>

In a workspace, click <mark style="color:blue;">Type: All</mark> to select one or more file types to display (for example, only Excel files or presentations). All types are shown when none are selected. Use the controls at the top right of the list to switch between <mark style="color:blue;">List view</mark> and <mark style="color:blue;">Thumbnail view</mark>.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-0db83e06a2c1b2a6238460208de5df15083bc043%2Ffile-library-type-filter.png?alt=media" alt="File type filter menu with multiple selections available, including PDF, Word, PowerPoint, and Excel"><figcaption><p>Select multiple types; leave all unchecked to show every type</p></figcaption></figure>

***

## File Details <a href="#file-details" id="file-details"></a>

Click a filename to open its details on the right, including:

* **Actions at the top**: Download, Move, Delete
* <mark style="color:blue;">Edit</mark> and <mark style="color:blue;">Upload new version</mark>: See [Online Editing](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/online-editing.md). After the file has been changed, <mark style="color:blue;">Versions</mark> also appears; see [Version History and Restore](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/versions.md)
* **Basic information**: Size, file location, creation time, creator, update time, updater, and source (such as <mark style="color:blue;">Upload</mark> or <mark style="color:blue;">Agent output</mark>). AI-generated files also show the source workspace and the conversation that generated them
* **File preview**
* <mark style="color:blue;">Start conversation</mark>: Bring this file into a new MaiGPT conversation

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-4bbb0a527a9155c2673bd54336c8d152358d2605%2Ffile-library-file-detail.png?alt=media" alt="File details sidebar with Edit and Upload new version at the top, followed by basic information, a file preview, and a Start conversation button"><figcaption><p>File details sidebar</p></figcaption></figure>

***

## Bulk Actions <a href="#batch-actions" id="batch-actions"></a>

Select the checkboxes on the left of the list (or select all using the header checkbox) to display actions such as <mark style="color:blue;">Move</mark> and <mark style="color:blue;">Delete</mark> at the top. You can process up to **200** files at a time. For a single file, you can also use the row's <mark style="color:blue;">⋯</mark> menu to <mark style="color:blue;">Download</mark>, <mark style="color:blue;">Rename</mark>, <mark style="color:blue;">Move to…</mark>, or <mark style="color:blue;">Delete</mark> it.

{% hint style="info" %}
You can restore deleted files from the workspace's <mark style="color:blue;">Version history</mark>. See [Version History and Restore](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/versions.md) for details.
{% endhint %}

***

## Related Pages <a href="#related" id="related"></a>

* [Create Workspaces and Import Files](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/create-and-import.md)
* [Use Workspaces in MaiGPT](https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/use-in-maigpt.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/work/file-library/search-and-details.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
