Skip to main content
Add a watermark or logo to your video for branding, ownership, or attribution. Useful for creators, brands, agencies, or clients who want consistent visual identity across content.

​
How It Works

The Watermark tile places an image overlay (logo or watermark) on top of your final video. You can use Mosaic’s default branding or upload your own logo for custom branding. Add your beautiful logos/@name tags

​
Input & Settings

​
Logo Source

Choose one:
  • Use Mosaic Logo — Quick default branding
  • Use Custom Logo — Upload your own PNG/JPG (recommended for creators & brands)

​
Position

Pick where the watermark should appear. Common presets include:
  • Bottom Right (default)
  • Bottom Left
  • Top Right
  • Top Left
Choose based on platform and composition.

​
Size

Adjusts logo size as a percentage of video width.
Example from screenshot:
  • 30% of width → medium branding

​
Opacity

Controls visibility (0–100%).
Examples:
  • 20–40% → subtle watermark
  • 70–100% → strong visible branding

​
Margin

Adds spacing (in pixels) from the video edges to avoid clipping or interference with captions.

​
API Info

  • Node ID: 6808af58-2d9a-4e3b-aacb-2d9c143b7729

​
Node params

ParamTypeRequiredDefaultNotes
use_custom_logo"mosaic" | "custom"Yes"mosaic"Source mode for watermark image.
image_idstring (UUID)ConditionalnullRequired when use_custom_logo="custom".
logo_position"top-left" | "top-right" | "bottom-left" | "bottom-right"Yes"bottom-right"Overlay anchor position.
logo_sizenumber (percent)Yes30Relative watermark width scale.
logo_opacitynumber (percent)Yes8010-100 in UI contract.
logo_margin_xnumber (px)Yes20Horizontal edge offset.
logo_margin_ynumber (px)Yes20Vertical edge offset.

​
Parameter groups

  • Logo source: use_custom_logo, image_id
  • Placement & sizing: logo_position, logo_size, logo_opacity, logo_margin_x, logo_margin_y

​
Scenario requirements

  • If use_custom_logo="custom", provide a valid image UUID in image_id.

​
Runtime notes

  • Backend validates image_id and fetches source dimensions before composing placement.
  • Existing watermark-related tracks are removed/replaced by the new operation.

​
Example

{
  "use_custom_logo": "custom",
  "image_id": "cccccccc-dddd-eeee-ffff-000000000000",
  "logo_position": "bottom-right",
  "logo_size": 30,
  "logo_opacity": 80,
  "logo_margin_x": 20,
  "logo_margin_y": 20
}