Core Concepts

Media Management

Upload and manage images, documents, and files. All media is stored in Amazon S3 on your own AWS account.

Uploading Media

Before creating content with images, upload them to your media library. All files are stored in Amazon S3 on your own AWS account and served directly from there.

Step by step

  1. Go to Media in the sidebar
  2. Drag and drop files onto the upload area (or click to browse)
  3. Add alt text for SEO and accessibility
  4. Done — your file now has a public S3 URL ready to use

Tip: Always add descriptive alt text to your images. It improves SEO and makes your content accessible to screen readers.

Media Features

CloudSource handles the heavy lifting so you can focus on your content.

20 MB Max

Per file. Images, PDFs, videos, documents — any file type.

Auto-detect

Image width and height are detected automatically.

Per Space

Each space has its own isolated media library.

Using Media in Content

Content models can include media and media_multiple field types to reference files from your media library.

How the Media Picker Works

When editing a content item, click on a media or media_multiple field to open the media picker. From there you can:

1 Browse all uploaded files with visual thumbnails
2 Select a single file for media fields (e.g. a hero image or thumbnail)
3 Select multiple files for media_multiple fields (e.g. a photo gallery or file attachments)
media

Single Media

Picks one file. Perfect for hero images, thumbnails, or document attachments.

media_multiple

Multiple Media

Picks multiple files. Ideal for photo galleries, slideshows, or file collections.

Media object in the API response

{
  "hero_image": {
    "id": 5,
    "url": "https://bucket.s3.amazonaws.com/uploads/hero.jpg",
    "filename": "hero.jpg",
    "mime_type": "image/jpeg",
    "width": 1200,
    "height": 630,
    "alt_text": "A scenic mountain landscape"
  }
}