Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.marblecms.com/llms.txt

Use this file to discover all available pages before exploring further.

Marble handles your media so you can focus on writing. Upload files to your workspace, keep useful metadata with them, and serve them through Marble’s CDN.

​
Supported media types

Images

Upload common image formats including JPEG, PNG, GIF, AVIF, and WebP. Images include dimensions when Marble can read them.

Videos

Host video files such as MP4 and WebM for posts, pages, and custom frontends.

Audio

Store audio files such as MP3, WAV, OGG, and AAC for use in custom experiences.

Documents

Upload documents such as PDFs and plain text files when you need CDN-backed downloads.

​
How it works

When you upload media to Marble, the file is stored in Marble’s object storage and served from a CDN URL.
  • Fast delivery — Media is served from cdn.marblecms.com
  • Stable URLs — Use the returned URL in posts, websites, apps, or feeds
  • Metadata included — Marble stores fields like name, alt text, MIME type, size, media type, dimensions, duration, blur hash, and upload date when available

​
Using media in your posts

1

Open the Media Library

In the Marble dashboard, click on Media in the sidebar to access your media library.
2

Upload Files

Click Upload to add images, videos, audio, or documents. Files are available as soon as the upload finishes.
3

Insert into Posts

When editing a post, use the image or video controls to insert media from your library. You can also paste CDN URLs directly.

​
Accessing media via API

You can read and manage media through the public API.
EndpointDescription
GET /v1/mediaList media assets in your workspace.
GET /v1/media/:idGet one media asset and its metadata.
POST /v1/media/uploadUpload a small file directly. Requires a private API key.
PATCH /v1/media/:idUpdate media metadata. Requires a private API key.
DELETE /v1/media/:idDelete a media asset and its stored file. Requires a private API key.
Uploads through the API are intended for small files. For larger uploads, use the dashboard uploader.
As a rule of thumb, avoid using very large images in your posts. Users with slower internet connections will experience longer load times, which can hurt engagement.

​
Managing your media

From the Media Library, you can:
  • Search and filter — Find files quickly by name or media type
  • Edit metadata — Keep names and alt text useful for humans and frontends
  • Delete unused files — Remove media you no longer need
  • View file details — See URL, file size, MIME type, dimensions, and upload date

​
Using media with MCP

Marble’s MCP server includes media tools for AI agents. Agents can list media, inspect a single asset, update metadata, delete assets, and upload media from a public URL.
Remote MCP servers cannot read files from your local filesystem directly. To upload through MCP, provide a URL that the server can fetch.
Deleting media removes the stored file. Any post, website, app, or feed that uses that URL will stop loading it, so update those references before deleting an asset.