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

# Media

> Browse, filter, download, and delete every file uploaded across your workspace.

## Overview

The Media library is a single place to manage every file your workspace has
stored: images, documents, spreadsheets, presentations, audio, video, and
more. Each file is listed with its type, MIME type, size, who uploaded it, the
record it's attached to (if any), and when it was created.

## How it works

Files in Custral are stored as resources backed by secure cloud storage. When
you open the Media library, each file's download link is a freshly signed,
time-limited URL rather than a permanent public link.

Files can be standalone or attached to a record, for example an image dropped
into a record's file field. The library exposes two tabs:

* **All Media**: every resource in the workspace.
* **Record Files**: only resources linked to a record, with the record name
  shown so you can see where each file is used.

Uploads are validated against a global list of supported file types, and total
storage counts against your plan's storage limit.

## Using it

<Steps>
  <Step title="Open Media">
    Go to **Settings → Media**. The **All Media** tab lists every file; switch
    to **Record Files** to see only files attached to records.
  </Step>

  <Step title="Filter and sort">
    Use the filter bar above the table to narrow by name, type, size, uploader,
    record, or date, and to sort the list.
  </Step>

  <Step title="Open or download a file">
    Click the **Download** action on a row to open the file in a new tab. Audio
    files also show a **Play** action.
  </Step>

  <Step title="Delete a file">
    Click the **Delete** (trash) action and confirm. The file is removed from
    the workspace.
  </Step>
</Steps>

<Warning>
  Deleting a file is permanent. If the file was attached to a record, that
  attachment will no longer resolve.
</Warning>

<Note>
  The Media library is for browsing and managing files that already exist.
  Files get added through the places you use them, for example, a record's
  file field or an AI image auto-fill. Rather than uploaded directly here.
</Note>

## Troubleshooting

| Symptom                                               | Likely cause                                     | What to check                                                                    |
| ----------------------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------- |
| Download link opens an error or expired page          | Signed URLs expire after a short window          | Reload the Media list to mint a fresh link, then download again                  |
| A file shows no record in the Record column           | The file is standalone, not attached to a record | Use the **All Media** tab. Record Files only shows linked files                  |
| Upload elsewhere fails with "storage limit reached"   | The workspace is at its plan storage limit       | Delete unused files here, or upgrade the plan's storage                          |
| Upload elsewhere fails with "file type not supported" | The file's type isn't on the global whitelist    | Convert the file to a supported format and retry                                 |
| Size column shows "-"                                 | The resource has no recorded size                | Re-upload the file; older or externally-created resources may lack size metadata |

<Note>
  When reporting an issue, include the request id shown in the error toast.
  It links the in-app error to the server logs.
</Note>

## Related

* [Records overview](/data/records/overview)
* [Record fields](/data/records/fields)
* [Spreadsheet property](/data/properties/communication/spreadsheet)


## Related topics

- [File](/data/properties/general/file.md)
- [SMS](/comms/sms/overview.md)
- [Long Text](/data/properties/text/long-text.md)
- [Recording](/comms/voice/recording.md)
- [Settings](/start/settings/overview.md)