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

# Media library

> Upload, generate, and organize the images and files your site uses, all in the Assets tab.

The media library is your site's file store. Open it from the **Assets tab** (the image icon) in the top navigation — you'll see a grid of your files with a folder sidebar on the left.

## Find recent files

Select **Recent** at the top of the folder sidebar to see files from every folder in one place. New uploads and later changes rise to the top automatically.

Each card shows its folder path and last modified date. Select the path to open that folder. To add files or folders, first open **All assets** or a folder.

## Add files

Click the **Plus (+) dropdown** at the top, which offers three options:

* **Upload File** — pick files from your computer.
* **Generate Image** — create an AI image (see below).
* **New Folder** — make a folder to organize your files.

You can also **drag and drop** files straight onto the grid. An upload dialog shows progress, and your files are ready to use once it finishes.

## Organize and preview

* Create folders from the **Plus (+) dropdown**, and **right-click** a file to move it.
* Click any file to open a preview — images show full size, videos and audio get a player, and 3D files open an interactive viewer.
* The preview shows metadata and editable **name**, **alt text**, and **caption** fields. When metadata is missing, Fimo generates suggestions automatically — you'll see a **Generating with AI** indicator, then an **AI generated** badge — and you can edit the suggested text inline.
* Images generated by an agent keep the contextual alt text and caption supplied for the current page or content entry. Fimo only generates metadata that is still missing, and preserves an intentionally empty alt text for decorative images.
* Sort the grid by date added, last modified, name, file size, or type, with a separate **Ascending / Descending** toggle.

To select multiple files, use their **checkboxes**, then **delete** or **move** them from the bulk action bar.

## Generate an image with AI

<Steps>
  <Step title="Open Generate Image">Click the **Plus (+) dropdown** and select **Generate Image**.</Step>

  <Step title="Describe it">
    Write a prompt — for example, "a flat illustration of a mountain landscape at sunset" (up to 2,000 characters).
  </Step>

  <Step title="Choose quality and shape">
    Pick draft for fast exploration, standard for everyday use, or premium for the highest detail. Then choose 1:1,
    16:9, 4:3, 9:16, or 3:4. The image generates and lands in your current folder.
  </Step>
</Steps>

<Tip>
  You can hand files to the AI chat, too: use the chat's **+** button to **Attach Assets** or **Upload from Computer**,
  type **@** to reference a file inline, drag a file into the chat, or just ask by name — "Use the hero-banner image on
  the home page."
</Tip>

## What's next

<Columns cols={3}>
  <Card title="Visual editing" icon="pen" href="/docs/studio/visual-editing">
    Swap images directly on the page.
  </Card>

  <Card title="CMS dashboard" icon="database" href="/docs/studio/cms">
    Use media inside your content entries.
  </Card>

  <Card title="AI chat" icon="comments" href="/docs/studio/ai-chat">
    Ask the AI to place or generate images.
  </Card>
</Columns>