The media library

Where all your uploaded images and documents live, and how to pick them when you’re writing.

What the library holds

The media library is the shared home for every file you’ve uploaded — cover images, inline photos, diagrams, PDFs, and any attachments you want readers to download. Find it in the dashboard sidebar under Workspace → Media.

You see your own uploads by default. Editors and admins can flip a Show all authors toggle to browse the whole library across the team.

Uploading a file

At the top of the library is an upload area. You can either:

Click the dashed box and pick a file from your computer.
Drag a file from your desktop and drop it on the box.

Uploads are one file at a time. The file uploads, then becomes available in the library immediately.

Supported types

Images — PNG, JPG, WebP, GIF, SVG
Documents — PDF, Word, Excel, plain text, markdown, RTF

Size limit

The maximum file size is 25 MB. If you’re uploading a large image, compress it first — most web images don’t need to be more than a few hundred kilobytes.

Switching views

The library has three ways to look at your media:

Grid — a wall of thumbnails. Easiest for picking by sight.
List — compact rows with filename, size, and upload date. Easiest for scanning a lot of files.
Detail — larger cards with full metadata.

Use the tabs above the library to filter by type — all media, images only, or documents only. The library remembers which view you prefer.

Picking media while writing

You don’t need to visit the library directly to use something from it. The same picker opens from three places in the editor:

Cover image button in the metadata panel — limited to images.
/image slash command — inserts an image inline. See the slash menu.
/file slash command — attaches a downloadable file inline.

Inside the picker you can also upload a new file — anything you upload is auto-selected so you can insert it straight away.

Paste or drop directly

You can paste an image from the clipboard or drag one straight into the editor. It uploads and inserts in one step — no dialog in the way.

Alt text for images

When you insert an inline image, the editor asks for alt text — a short description for readers who use screen readers or have images turned off. If the image is purely decorative (a separator or visual flourish), tick the decorative option instead.

Alt text is set per insertion — the same image used in two posts can have different alt text in each. Keep it under 250 characters and describe what’s in the image, not the fact that it’s an image.

Generating a cover image with AI

When picking a cover image, the picker has an AI generation option. Type a short prompt — what the image should depict — and the system produces an editorial-style image with no text. Generation takes around 10–30 seconds.

The picker pre-fills the prompt with your post’s excerpt or title as a starting point. Edit it before generating to push the result in the direction you want.

Inspecting and removing a file

Click any media item to open its detail panel. From there you can:

See the filename, size, type, and upload date.
Copy the file’s embed URL to the clipboard — useful if you want to reference it from somewhere outside the editor.
Download the original file.
See every post or publication the file is currently used in.
Delete— but only if the file isn’t in use anywhere.

Removing references first

If a file is attached to a post, you can’t delete it from the library directly. Remove it from the posts that use it first, then come back and delete.

How the URLs work

Every uploaded file gets a stable address of the form /m/{id} on the public blog. That URL never changes for the lifetime of the file, even though the underlying storage rotates the actual download link every hour or so.

That means once you’ve embedded a file in a post — or copied its URL to share elsewhere — the link keeps working indefinitely without you having to do anything.