Media

The Media Library is accessible from the Media link in the sidebar. It shows all assets uploaded to the current space and environment.

Uploading files

Click Upload and select one or more files. Supported types include images (JPEG, PNG, GIF, WebP, SVG), videos, and PDFs.

Uploaded files are stored in Cloudflare R2 at the path:

{spaceId}/{environmentId}/{assetId}/{filename}

Searching assets

Use the search bar at the top of the media library to filter assets by filename or alt text.

Asset metadata

Click any asset to open its detail panel. You can edit:

• Alt text — Descriptive text for accessibility and SEO
• Filename — Display name (does not affect the R2 storage key)

Using assets in content

In the page editor, fields of type image open the media library picker. Select an asset to insert it.

The field stores a reference to the asset’s URL, which is served directly from R2.

Deleting assets

Click the ⋯ menu on an asset and select Delete. This removes both the metadata from D1 and the file from R2.

Caution

Deleting an asset does not update any pages that reference it. Make sure the asset is no longer in use before deleting.

Pagination

The media library loads 50 assets per page. Use the pagination controls at the bottom to navigate.