Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

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

Media Flow lets you upload, organize, and serve media files from BRICKS Controller. Your applications can display images, videos, and other media served through the BRICKS CDN.
Media Flow requires a workspace with Media Flow enabled. Check your workspace subscription for availability.

​
Media boxes

Media boxes are containers that organize your files by category or purpose. Each box holds a collection of media files.

​
Create a media box

  1. In BRICKS Controller, go to Media
  2. Click Create Box
  3. Enter a name for the box

​
View files in a box

Click on a media box to browse its files. You can filter by:
  • File type — Images, videos, documents
  • User tags — Custom tags you assign to files

​
Uploading files

1

Open a media box

Navigate to the media box where you want to upload files.
2

Upload

Click Upload and select one or more files from your computer.
3

Configure options

Add a description, tags, and configure image processing options.

​
Upload options

OptionDescription
DescriptionA text description of the file
User tagsCustom tags for organizing and filtering (up to 15 per file)
Image versionsGenerate resized versions at specific dimensions (e.g., 800x600)
AI analysisRun AI analysis on the file with optional custom instructions

​
Image processing

When uploading images, you can generate additional versions at specific dimensions:
  • Define the target size (e.g., 800x600)
  • Choose a fill mode (e.g., FILL, FIT)
  • Select an output format
Processed versions are stored alongside the original and served through the CDN.

​
Using media in applications

Your applications access media files through the BRICKS CDN. Files are served with optimized caching and delivery.

​
CLI access

You can also manage media from the BRICKS CLI: 
# List media boxes
bricks media boxes

# List files in a box
bricks media files <box-id>

# Upload files with tags and image processing
bricks media upload <box-id> image.png -t "banner" --image-version "800x600:FILL"