Brease Docs

Media library

Upload, describe and find the site's images and documents.

Every image and document used on the site is in the site's Media library, on the dashboard. The editor's image picker and the AI use the same library.

Upload

Drop files onto the page or click Upload. You can upload:

  • images: PNG, JPEG, GIF, WebP, AVIF and SVG;
  • documents: PDF, Word (.docx), text, Markdown and CSV;

up to 25 MB each.

Before the upload, Brease asks for details:

  • Alt text (required for images): a short description of what the image shows, in at least one of the site's languages. Screen readers read it aloud to people who can't see the image, and search engines use it. "Pupils building a robot in the science lab", not "image1".
  • Description (optional): more detail that helps you and the AI find the image later: who or what is in it, the setting, the mood. Leave it empty and Brease writes one automatically, for a few credits.

The Upload button waits until every image has alt text.

Find files

The search box searches file names, alt texts and descriptions at once, and forgives small typos and missing accents. Every word you type has to match somewhere, so "robot lab" narrows the results to images that mention both. Good alt texts and descriptions make files easier to find, for you and for the AI.

Edit and delete

Click a file to open it. You can change its alt text and description and Save, copy its URL, and see whether it's Used in the live release.

Delete removes it for good, after you confirm. A file on the live site can't be deleted: remove it from the page and publish first. If an older release or a draft used it, restoring or reopening that shows the Brease placeholder in its place, and Brease tells you which pages are missing media.

Let the AI help

In the editor, the AI can write or improve alt texts, and make large images lighter (scaled down and saved as WebP) so pages load faster. It asks you to Verify each of these before anything changes; for images, the card shows each one's size before and after. Once verified, your pages use the lighter files, and the live site switches with your next publish.

The Brease placeholder

The first entry in every library is Brease placeholder: the image new sections start with. It can't be changed or deleted, and the image pickers don't offer it. Replace it in your sections with a real image.

On this page