Skip to content

Media Library

The Media Library is a unified file browser that talks directly to your configured storage backend (Local / GCS / S3 / R2). It lets you manage all uploaded files — images, attachments, exports — without using a separate cloud console.

  • Folder navigation — drill into nested directories on the storage backend
  • Upload — drag-and-drop or click-to-select multiple files
  • Delete — single or bulk
  • Copy — copy the storage path or the public URL of any file
  • Download — pull a file back to your local machine
  • Search — filter by filename within the current folder
  • Pagination — 30 items per page

Baan uses certain reserved prefixes for internal data (e.g. _settings/, _auth/, _themes/). The Media Library hides these automatically — they cannot be browsed, modified, or deleted from the UI. This keeps user-managed media separate from Baan’s own runtime files and prevents accidental damage.

The Media Library is a thin UI over the storage abstraction. The same operations work identically across all backends:

BackendNotes
LocalFiles live in ./content/ on the server (self-hosted only)
GCS / S3 / R2Cloud storage with a configured bucket

Switching the backend is done from Settings → System → Storage. Existing media can be migrated when you switch.

Files uploaded via the Media Library are also accessible through the Headless CMS API — the POST /api/cms/v1/media endpoint adds files to the same library, and they appear in the UI immediately.