---
title: "Media library and uploads"
url: "/help/buuk/media-library"
updated: "2026-10-22T11:13:36.392Z"
---
# Media library and uploads

There is no separate media-management screen in the dashboard. Uploads live in the articles that use them, and every file Buuk inserts keeps its stable address in the workspace's asset store.

## What happens on upload

1. Press `/` and choose **Image** or **Video** to open a file picker.
2. The file compresses in your browser, then uploads.
3. Buuk stores the file and inserts the block, pointing at the asset address.

Every upload returns a stable address like `/api/media/assets/<id>` that keeps working as long as the content that embeds it does. Your editor autosaves, so an uploaded file is already part of the draft before you finish writing.

## Limits

- A file can be up to 24 MB.
- Images: PNG, JPG, WebP, and GIF.
- Videos: MP4, WebM, and MOV.

Compression rules live in [Images and lightbox](./images-and-lightbox) and [Videos](./videos).

## Storage

Files are stored outside the article — object storage when the workspace has it configured, with the database as a fallback so uploads never fail outright. AI-drafted screenshots, up to three per draft when an **App URL** is set (see [Images and screenshots](./images-and-screenshots)), land in the same store as your uploads.

## Public access

A reader's browser can load a file you uploaded only when it is visible on the public site: embedded in a published article, or used somewhere in the reader-facing chrome. Drafts keep their files private until you publish.

The same asset address can appear in more than one published article — public access follows the content that embeds it. With a private help center, readers who are not signed in cannot get files at all.

## Managing media in articles

Working with a file means working with its article. Open the article, swap the image or video block for a new upload, and republish.

Version history keeps earlier article snapshots, so an image you removed can come back with a restore.

## Related

- Read [Images and lightbox](./images-and-lightbox) for upload behavior and alt text.
- See [Videos](./videos) for video files and hosted links.
- See [Images and screenshots](./images-and-screenshots) for AI-drafted captures.
- See how unpublished drafts work in [Write and publish an article](./write-and-publish-an-article).