Overview
Media Assets is where your team keeps the pictures and videos you use in widgets. Upload once, organize with tags, then pick from the library inside the composer. Images and videos live in separate libraries so the Image picker never shows video files, and the Video picker never shows pictures.
Files are stored with RuleCMS's media host and delivered through optimized URLs in published content. Metadata (tags, ownership, optional default settings) is tracked in RuleCMS.
Images and videos
| Library | What belongs here | Where to open it | Used by |
|---|---|---|---|
| Images | Photos, illustrations, icons, posters (JPG, PNG, WebP, GIF, SVG, and similar). About 10 MB per file. | Team dashboard → Images, or …/t/[teamId]/images | Image component, Poster Image on a Video, and other image fields |
| Videos | Clips in MP4, WebM, or MOV. About 100 MB per file. | Team dashboard → Videos, or …/t/[teamId]/videos | Video component |
Where media lives
Images and videos belong to one team. Team members with media permissions can browse and pick files; manage permission is required to upload, edit defaults, and delete. There is no org-level media library. Isolation is at the team boundary, the same as Component Libraries.
Uploading an image
- Open Images for your team, then Upload (or go to
…/t/[teamId]/images/upload). - Choose a supported image file under the size limit.
- Optionally add up to five tags (letters, numbers, and hyphens). Your team id is always applied automatically.
- Upload. The file goes to the media host with a signed request; RuleCMS then saves the metadata so the image appears in your library and in the composer picker.
Uploading a video
- Open Videos for your team, then Upload (or go to
…/t/[teamId]/videos/upload). - Choose an .mp4, .webm, or .mov file under about 100 MB.
- Optionally add tags the same way as for images. Tags help you find the clip later in the Videos browser and in the Video Selector.
- Upload and wait for the transfer to finish. Large files take longer; keep the tab open until you see success.
After upload you can open the video's detail page to set default playback settings (controls, autoplay, loop, muted, plays inline, preload, intrinsic size, and optional transformations). When someone later picks that video in the composer, empty Video settings on the component can fill in from those defaults.
Browsing and selecting
- Composer Image fields — open the image library with search, tags, and thumbnail size options. Selecting an asset can prefill image settings such as width, height, and alt text when those defaults were saved on the asset.
- Composer Video Selector — opens the video library only. See the Video component docs for playback settings after you pick a clip.
- Poster Image on a Video — picks from the image library (not the video library). Upload the still in Images first if you need a custom poster.
Asset detail pages
Click an asset to preview it, review tags and delivery details, and edit the optional defaults that prefill the composer:
- Images:
…/images/[teamTagPublicId] - Videos:
…/videos/[teamTagPublicId]— preview plays in the browser; the defaults editor covers the Video component settings listed above
Using media in a page
- Upload under Images or Videos.
- In the composer, drop an Image or Video component.
- Open Selected Component and use Media Selector or Video Selector to pick the file.
- Adjust column Width/Height for layout; use the component's own settings for alt text (images) or playback (videos).
Permissions summary
- View media assets — browse libraries and select files in the composer
- Manage media assets — upload, edit tags and per-asset defaults, and delete team assets
The same permissions cover both images and videos.
Practical tips
- Prefer short clips for page content. Long files slow the first paint even when the player only preloads metadata.
- Autoplay on the published page only works when the video is muted — browsers block autoplaying sound.
- Video has no alt text. If the clip carries information your page depends on, put that in words nearby (caption, summary, or transcript).
- Set intrinsic width and height (on the asset defaults or on the component) so the layout does not jump while the file loads.