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

# Library

> Everything you upload or generate in Rheos lives in the Library. Upload files and folders, import from Google Drive or OneDrive, and attach assets to posts.

The **Library** is where every file in your workspace lives. It's the second item in the
sidebar, at `dashboard.rheos.app/library`.

It holds:

* Images, video and audio.
* Documents — PDF, Word (`.docx`) and plain text.
* Visuals you save out of the [Image Studio](/help/posts/image-studio).

Individual files can be up to 2 GB.

## What's on the page

Reading down from the top:

1. **The header row** — **Library** on the left. On the right, a zoom slider (a magnifier
   icon with a slider) that resizes the thumbnails, then the **+** button. The slider only
   appears in grid view.
2. **The search box**, centred on its own row underneath.
3. **The Create band** — a **Create** heading with a **New Post** card that starts a new
   post. Opening a folder or typing a search hides it.
4. **The filter bar** — type toggles, view switcher, filters, sort and select. It sticks to
   the top of the list as you scroll.

Below those come the folder strip and the file grid.

## Getting files in

Select **+** at the top right of the Library:

| Option                       | What it does                                                                     |
| ---------------------------- | -------------------------------------------------------------------------------- |
| **Upload Files**             | Pick files from your device.                                                     |
| **Upload Folder**            | Pick a folder from your device. Rheos rebuilds its structure as Library folders. |
| **Import from Google Drive** | Browse your Drive and pick files, or import a whole folder.                      |
| **Import from OneDrive**     | The same, for OneDrive.                                                          |
| **New Live Document**        | Not a file — see [Live Documents](/help/library/documents).                      |

Sign in to Google or Microsoft when prompted — you don't need to set anything up
beforehand. Files are copied into your Library rather than linked, so later edits in
Drive or OneDrive don't flow through.

You can also drag files or a folder straight onto the page. A **Drop files to upload**
overlay appears while you drag. Drop a `.zip` and Rheos reads it first, then asks whether
to **Extract contents** or keep the archive whole with **Import as file**.

### The upload dialog

Uploads and cloud imports open **Upload Assets** before anything is stored. Along the top
you can set:

* **Brand** — which brand these files belong to. It's pre-set to the brand you have
  selected in the sidebar.
* **Choose Folder for All** — send the whole batch to a Library folder.
* **Add Tags to All** — tag the batch in one go.

Each file also has its own **Name**, **Folder** and **Notes**, and images get a crop
button. **Upload** commits the batch; **Cancel** stores none of it.

<Warning>
  **Upload Folder** — and dragging a folder onto the page — behaves differently. Rheos
  rebuilds the folder structure as Library folders *before* the dialog opens, and confirms
  with a message like **Found 12 files across 3 folders**. If you cancel **Upload Assets**
  after that, no files are stored, but the new (empty) folders stay in your Library.
  Right-click each one and pick **Delete**, then confirm in the dialog.
</Warning>

## Folders

Folders sit in a strip above the grid, each with an item count. Select a folder to open it;
the breadcrumb takes you back to **Library**.

* Select the dashed **+** card at the end of the strip to create a folder.
* Drag assets onto a folder card to move them in.
* Drag assets onto the dashed **+** card to create a new folder that already contains them.
* Drag a folder onto another folder to nest it.
* Right-click a folder to **Rename** or **Delete** it. Deleting a folder with contents
  asks whether to **Keep contents** or **Delete everything**.

Your folders also appear under **Library** in the sidebar, below **All files**.

## Finding things

Type in the search box at the top of the Library. Give it at least three characters and
use plain language — Rheos matches on meaning as well as on file names, tags and
descriptions.

The filter bar below holds the rest:

* A **Library** / **Sessions** switcher at the far left. **Sessions** lists the creation
  sessions you've run; **Library** is the file view this page describes.
* **Images**, **Video**, **Audio**, **Documents** — type toggles. Turn on any combination.
* **Bin** — the recycle bin.
* Grid or list view.
* A filter icon, which opens **Source** (**Uploaded** or **Studio**), **Aspect Ratio**
  (**Square**, **Portrait**, **Landscape**) and **Date** (**Last 7 days**,
  **Last 30 days**, **Last year**). **Tags** and **Campaigns** join them once you have
  some.
* Sort by **Uploaded** or **Name**, ascending or descending.
* **Select** — turn on selection mode.

To resize the grid, use the zoom slider in the header row next to **+** — not the filter
bar. It's hidden in list view.

<Note>
  The Library shows the brand you have selected in the sidebar, plus anything that isn't
  tied to a brand. If a file you expect is missing, check the brand selector first.
</Note>

## Selecting and acting on assets

Cmd-select (Ctrl-select on Windows) to add an asset to the selection, or Shift-select to take
a range. If you'd rather not hold a key, select **Select** in the filter bar first — after
that, a plain select adds and removes assets.

A bar docks to the bottom of the screen as soon as anything is selected. It shows the
count and offers:

* **Add to post** — attach the selection to an existing draft.
* **Move to folder** — pick any Library folder. From inside a folder you can also move
  things back to **Library Root**.
* **Download** — download every selected file.
* **Create post** — start a new post from the selection. Two or more images become a carousel.
* **Edit** — one asset at a time; opens **Edit Info** with **Asset Name**, **Project** and
  **Internal Notes**.
* **Delete** — moves the selection to the bin.

Right-clicking an asset gives the same set plus **Rename** for inline renaming. The clear
button at the left of the bar drops the selection.

## Attaching an asset to a post

There are two routes, and they end in the same place.

<Steps>
  <Step title="From the Library">
    Select one or more assets and select **Add to post**. **Add to existing post** lists
    your drafts — select one and the assets are attached. Use **Create post** instead if
    you want a brand-new post built around the selection.
  </Step>

  <Step title="From the post editor">
    In the [Unified Post Editor](/help/posts/unified-post-editor), use the **Attachments**
    card. **Attach** (*Upload or library*) opens the **Add Assets** picker on your
    Library — pick your asset and confirm. Once the post has an attachment, the **+** tile
    alongside the thumbnails opens the same picker, and an **Attach** button sits under
    them.
  </Step>
</Steps>

## The bin

**Delete** doesn't destroy anything straight away. Deleted assets move to the bin, which
you open with the **Bin** icon in the filter bar. Before you commit, the **Move to Trash?**
dialog names any posts that use the asset and warns that it will be removed from them.

From the bin, select assets and pick:

* **Restore** — then either **Restore Locations** to put them back in their old folders
  and campaigns, or **To Library Only**.
* **Delete forever** — permanent, and not reversible.