> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tessact.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Content Library & Asset Management

> Organise, navigate, and perform bulk actions on large volumes of media with Tessact’s scalable Library.

## Overview

The **Library** is Tessact's main workspace for storing and operating on media. It brings together folders, uploads, metadata, review, and access controls in one place so teams can move from ingest to collaboration without switching tools.

<Frame caption="Live Library workspace showing navigation, search, actions, and uploaded assets">
  <img src="https://mintcdn.com/tessact/L-fkvCWUR2rHtsQI/images/library-review/library-overview-live-v2.jpg?fit=max&auto=format&n=L-fkvCWUR2rHtsQI&q=85&s=e5958dede99e578d8b7e8afd39be52ac" alt="Tessact Library live workspace" width="1600" height="1000" data-path="images/library-review/library-overview-live-v2.jpg" />
</Frame>

***

## What You Can Do In The Library

* Browse folders and files in **grid** or **table** view.
* Upload assets directly into the current location.
* Search, filter, sort, and group assets using metadata.
* Open any asset into a dedicated detail page for **preview**, **comments**, **metadata**, and **technical information**.
* Update statuses, apply templates, and manage access without leaving the asset.

<Info>
  The Library is not just a browser. It is also where the core review workflow starts: open an asset from the Library to comment, inspect detections, and work with metadata.
</Info>

***

## Selecting a View

Tessact offers two main presentation modes:

| View      | Best for                                     | Key controls                                          |
| --------- | -------------------------------------------- | ----------------------------------------------------- |
| **Grid**  | Visual browsing, marketing teams, thumbnails | Card orientation, thumbnail fit/fill, flatten folders |
| **Table** | Metadata-driven work, archivists, compliance | Column selection, pinning, custom metadata views      |

Use the **View selector** in the Library header to switch between views. Tessact preserves your working layout and then reuses it as you move through the workspace.

***

### Grid View Options

<Frame caption="Grid view settings panel (aspect ratio, fit/fill, flatten)">
  <img src="https://mintcdn.com/tessact/OGApNZ2NxI7GL1qW/images/grid-view-options.jpg?fit=max&auto=format&n=OGApNZ2NxI7GL1qW&q=85&s=ab8d3db6e016f598d7a601d0eed1cf52" alt="Grid view settings" width="878" height="872" data-path="images/grid-view-options.jpg" />
</Frame>

* **Vertical vs. Horizontal cards** — Optimise for portrait or landscape material.
* **Fit vs. Fill thumbnail** — Choose letterboxed accuracy or edge-to-edge crop.
* **Flatten folders** — Display every asset in the hierarchy as a single scrollable wall.

<Tip>
  Flatten folders when you need to inspect everything inside a nested folder structure without drilling into each child folder.
</Tip>

***

### Table View Customisation

<Frame caption="Customisable table with pinned columns and metadata fields">
  <img src="https://mintcdn.com/tessact/OGApNZ2NxI7GL1qW/images/table-view-options.jpg?fit=max&auto=format&n=OGApNZ2NxI7GL1qW&q=85&s=d612b531e5da264b6b6172313a59be18" alt="Table customisation" width="3202" height="1878" data-path="images/table-view-options.jpg" />
</Frame>

1. Select **View** → **Properties** to add metadata fields to the table.
2. Pin a column from its **⋯ context menu** to keep key fields visible while scrolling.
3. Reorder columns from the same menu to match each team's workflow.
4. Use the **Sort** and **Filter** controls in the top action bar to refine the current result set.
5. Group and sub-group rows by metadata when you need an editorial, operational, or compliance-driven view of the same assets.

<Info>
  The table can mix built-in fields such as name, creator, file type, and dates with custom metadata fields configured for your workspace.
</Info>

***

## Sorting, Filtering, and Search

The action bar at the top of the Library is the main control surface for narrowing large result sets:

| Control        | Behaviour                                                                                                                     |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Search**     | Search assets by name and other indexed fields visible in the Library workflow.                                               |
| **Filter**     | Add multiple filters across built-in fields, technical metadata, and custom metadata fields.                                  |
| **Sort**       | Add one or more sort criteria. The order inside the Sort bar defines precedence (primary, secondary, tertiary, etc.).         |
| **Upload**     | Upload new assets to the Library from your current device. For recommended file formats, see [Media Formats](/media-formats). |
| **New Folder** | Create a new folder in the current path.                                                                                      |

Common static filters include created date, modified date, creator, file type, codec, and extension. Tessact also exposes workspace-specific metadata fields in the same filtering flow, so operational teams do not need a separate search interface for custom schemas.

Filters and sorts carry across Grid and Table views, so you can refine in one layout and inspect in another.

***

## Folder Navigation

* Once you navigate into any folder in the library, the sidebar changes to show a tree view with the current folder selected.
* Toggle **Flatten folders** to surface every asset in descendant directories without changing sidebar context.

<Tip>
  Open folders for strict hierarchy work. Use flattening when you need a campaign-wide or shoot-wide view without changing where you are in the tree.
</Tip>

***

## Open An Asset

Click any asset to open its dedicated detail page. Tessact then gives you a larger working surface with:

* **Preview** for video, audio, images, documents, or other supported file types
* **Comments** for review and threaded collaboration
* **Metadata** for custom fields, templates, and AI-assisted entry
* **Technical metadata** for codec, bitrate, duration, and file-level details
* **Access** controls when your role includes security permissions

For version stacks, Tessact can route you to a specific version while keeping the stack relationship intact.

***

## Bulk Actions & Context Menus

<Frame caption="Asset right-click context menu with cut, copy, delete">
  <img src="https://mintcdn.com/tessact/OGApNZ2NxI7GL1qW/images/library-context-menu.jpg?fit=max&auto=format&n=OGApNZ2NxI7GL1qW&q=85&s=43dd50cf6089a23e097fcca7f1914551" alt="Context menu" width="1494" height="1218" data-path="images/library-context-menu.jpg" />
</Frame>

### Multi-select operations

1. Select multiple assets via checkboxes or drag selection.
2. The select bar appears at the bottom of the screen with a few options:

| Action                 | Description                                                   |
| ---------------------- | ------------------------------------------------------------- |
| **Cut / Copy / Paste** | Move or duplicate assets within the Library.                  |
| **Delete**             | Remove assets or folders from the current workspace location. |
| **Rename**             | Update names without opening a separate editor.               |
| **Select all**         | Apply bulk actions across the current result set.             |
| **Status updates**     | Update custom file statuses directly from supported views.    |

<Tip>
  Right-click menus are useful for focused operations on one item. Multi-select is better when you need to move, review, or clean up many assets at once.
</Tip>

***

## Performance at Scale

* **Virtual scrolling** renders only visible rows/cards for smooth performance on huge libraries.
* **Progressive loading** keeps long folders usable while more content streams in.
* **Background fetching** keeps permissions, thumbnails, and sub-content data fresh as you browse.
* **Live status refresh** updates ingest and indexing progress while uploads and analysis are running.

***

## Next steps

<Card title="Review assets with comments" arrow="true" horizontal href="/review-collaboration">
  Learn how comments, mentions, markers, and timed feedback work on asset pages.
</Card>

<Card title="Create custom statuses" arrow="true" horizontal href="/custom-statuses">
  Model editorial and approval stages directly inside the Library.
</Card>

<Card title="Search with AI" arrow="true" horizontal href="/ai-search">
  Jump from the Library into scene-aware search when keyword search is not enough.
</Card>

<Card title="Connect cloud storage (S3)" arrow="true" horizontal href="/s3-connections">
  Integrate external AWS S3 storage with your Library.
</Card>

***

<Check>
  You can now navigate, customise, and perform bulk actions in the Library with confidence. Explore the links above to extend your workflow.
</Check>
