Watermarks and test videos

Configure these options in Library → Upload video or Import URL before creating content. Mode and settings are fixed when the upload is reserved. On resume, the dashboard retrieves server settings and requests the original file.

Add a watermark

Add up to five PNG/JPEG images using their public URLs and adjust size, position, margins, and opacity. The dashboard does not download a remote preview. With the SDK, use a secondary input with overlay_settings:

const logo = {
  url: "https://media.example/logo.png",
  overlay_settings: {
    width: "20%",
    horizontal_align: "right" as const,
    vertical_align: "bottom" as const,
    horizontal_margin: "2%",
    vertical_margin: "2%",
    opacity: "90%",
  },
};
const asset = await orilla.assets.create({
  inputs: [{ url: "https://media.example/video.mp4" }, logo],
  playback_policies: ["signed"],
});

For a direct upload, use new_asset_settings.inputs: [{}, logo]. Sizes and margins accept % or px; one dimension preserves aspect ratio. Both dimensions set the box. Pixels scale from a 1920×1080 landscape or 1080×1920 portrait reference. Defaults: left, top, 0px margins, and 100% opacity.

Each image supports up to 10 MiB and 4096×4096 pixels; the resulting image cannot exceed 4096 pixels per side or 16 MP. SVG, GIF, WebP, APNG, and animated images are not supported. Positive sizes: up to 400% or 8192px; margins up to ±400% or ±8192px. Filter expressions are not accepted.

The watermark is burned into the canonical source: HLS, thumbnails, downloads, master, and subsequent clips retain it. The private original retains its source evidence. Watermarks cannot be edited after publication and are not supported on audio-only sources. A clip can add new images to an inherited watermark.

Create test content

Enable Create as test, or use test: true when creating an asset:

const testAsset = await orilla.assets.create({
  inputs: [{ url: "https://media.example/video.mp4" }],
  playback_policies: ["public"],
  test: true,
});

For a direct upload, use new_asset_settings: { test: true }. This mode limits the published source to its first ten seconds, adds “ORILLA TEST” to video, and schedules removal after 24 hours. Audio without video is limited without an image or audible watermark. The test watermark is applied after image overlays.

The details show Test content and the actual UTC expiration. Metadata edits cannot change the mode. Downloads and clips use the limited source; a clip from a test inherits its mode and cannot expire after its parent.

With native multipart, the 24 hours start when the asset is reserved. With compatible direct upload, they start when the asset is created after upload completion. Usage preserves bytes and duration of the accepted original source. See also limits and implementation status.