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

# File library

> Your school's searchable library of uploaded files and tutorial videos.

<Info>
  **School-level feature** — managed within your school portal at `yourschool.deandesk.com`.
</Info>

Every school has a **file library** — a searchable catalog of the files uploaded to your school, with author, tag, and category metadata. It lives at `yourschool.deandesk.com/files` (there's no sidebar entry — open the URL directly or share it as a link). A companion **video library** of tutorial videos lives at `yourschool.deandesk.com/tutorials`.

## Browse and search files

The Files page shows a search sidebar on the left and a results table on the right. On smaller screens the sidebar becomes a drawer — use the arrow toggle in the top-left corner to open and close it.

### Search filters

| Filter         | How it works                                                                               |
| -------------- | ------------------------------------------------------------------------------------------ |
| **Book Name**  | Matches against file titles (partial matches, case-insensitive)                            |
| **Author**     | Matches the author recorded on upload                                                      |
| **Tags**       | Type a tag and press Enter to add it as a chip; files matching any listed tag are returned |
| **Categories** | Same chip behavior as tags, matched against file categories                                |

Click **Search** to apply the filters, or **Clear All** to reset. Filters are reflected in the page URL, so a filtered view can be bookmarked or shared.

### The results table

Each file row shows the **File Name**, **Author**, **Upload Date**, and its **Tags & Categories** as chips. Clicking a tag or category chip adds it to the active filters — a quick way to pivot to related files.

Under **Actions**:

* The **download** icon downloads the file. Downloading requires a logged-in account — visitors see a **Members Only** prompt asking them to sign up or log in.
* The **delete** icon (admins only) removes the file after a confirmation dialog.

## Who sees what

File visibility is controlled per file:

| Audience                     | What they see                         |
| ---------------------------- | ------------------------------------- |
| Visitors and non-admin users | **Public** files only                 |
| Admins                       | All files, including **private** ones |

Browsing and searching the library is open to everyone (including logged-out visitors), but downloads always require an account.

## Uploading files and metadata

Files enter the library through the **Upload file** dialog, which appears wherever you attach files in DeanDesk — most commonly when creating course materials, but also on assignments and events. Drop a file (or click to browse), then fill in the **Optional details**:

| Field          | Purpose                                                                      |
| -------------- | ---------------------------------------------------------------------------- |
| **Author**     | Shown in the library's Author column and searchable                          |
| **Visibility** | **Public** (visible in the library to everyone) or **Private** (admins only) |
| **Tags**       | Type and press Enter to add each tag                                         |
| **Categories** | Type and press Enter to add each category                                    |

Good tags and categories are what make the library useful — they power the chip-based filtering on the Files page.

## Files and course materials

Course materials and the file library share the same storage. When you create a course material of type **File** (see [Course materials](/lms/courses)), the uploaded file is stored in the school's file library, and the material references it. That means:

* A file uploaded as a course material also appears in the library (subject to its visibility setting).
* Deleting a file from the library breaks any material that references it — prefer editing or removing the material instead.

Files synced by the [DeanDesk Sync](/integrations/deandesk-sync) desktop app follow the same path: they become course materials backed by library files.

## Video library

The video library at `yourschool.deandesk.com/tutorials` shows your school's tutorial videos in a grid with auto-generated thumbnails. Anyone can browse it; it lists videos that are **public** and in the **Tutorial** category.

### Upload a video (admins)

<Steps>
  <Step title="Open the video library">
    Go to `/tutorials`. Admins see an **+ Upload Video** button.
  </Step>

  <Step title="Fill in the details">
    Choose the **Video File** (MP4, MOV, AVI, WMV, or WebM) and enter a **Video Title**. Optionally add a **Description**, **Author**, comma-separated **Tags** and **Categories**, and set the **Visibility**.
  </Step>

  <Step title="Upload">
    Start the upload and wait for the progress bar to finish. DeanDesk automatically generates a thumbnail from the video.
  </Step>
</Steps>

<Note>
  New videos default to **private** visibility. To appear on the Tutorials page, a video must be set to **public** and include `Tutorial` in its categories.
</Note>

Admins can edit a video's details or delete it from the edit dialog on the video card or player.
