EmbeddingURL parameters
URL parameters
Configure the Moviie Player at load time using query string parameters.
The embed URL accepts public runtime parameters for the initial player state and
Studio preview parameters for temporary, non-persistent customization previews.
Parameters compose: append them with & in any order.
Boolean values are expressed as true or false.
Public runtime parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
autoplay | boolean | saved setting | Starts playback as soon as the player is ready. Most browsers require muted=true to honour this. |
preload | boolean | saved setting | Allows the player to prepare media before the viewer presses play. |
muted | boolean | saved setting | Loads the player muted. |
loop | boolean | saved setting | Restarts playback automatically after ended. |
controls | boolean | true | Hides the built-in controls when set to false. |
start | number (seconds) | — | Starts playback at the given offset. |
t | number (seconds) | saved setting | Starts playback at the given offset used by Studio/player-control previews. |
end | number (seconds) | — | Stops playback at the given offset. |
poster | string (URL) | — | Overrides the default poster image. |
lang | string | viewer locale | Locale used for the UI (en, pt-BR, …). |
cc | string | — | Pre-selects a captions track by language code. |
quality | string | auto | Forces a specific quality (e.g. 1080p). Falls back to auto if the value is unavailable. |
chromecast | boolean | saved setting | Shows or hides Chromecast support. |
disableAirplay | boolean | saved setting | Disables AirPlay when true. This legacy public parameter uses inverted polarity. |
showSpeed | boolean | saved setting | Shows or hides the playback speed control. |
rememberPosition | boolean | saved setting | Lets the player resume from the viewer's previous position. |
turboStart | boolean | saved setting | Forces TurboStart on or off for the current load. |
showProgress | boolean | saved setting | Shows or hides the progress bar. Smart Progress still hides the real seekbar when active. |
showPlay | boolean | saved setting | Shows or hides the compact play/pause control. |
showPlayLarge | boolean | saved setting | Shows or hides the large center play button. |
showCaptions | boolean | saved setting | Shows or hides captions and the captions control. |
showSettings | boolean | saved setting | Shows or hides the settings menu. |
showPip | boolean | saved setting | Shows or hides Picture-in-Picture. |
showFullscreen | boolean | saved setting | Shows or hides fullscreen. |
showCurrentTime | boolean | saved setting | Shows or hides the current playback time. |
showDuration | boolean | saved setting | Shows or hides the total duration. |
showMute | boolean | saved setting | Shows or hides the mute toggle. |
showVolume | boolean | saved setting | Shows or hides the volume slider. |
showSeekBackward | boolean | saved setting | Shows or hides the back 10s control. |
showSeekForward | boolean | saved setting | Shows or hides the forward 10s control. |
showChapters | boolean | saved setting | Shows or hides in-player chapters when the video has chapters available. |
showCtas | boolean | true | Shows or hides video CTAs for the current load. |
Studio preview parameters
The parameters below are intended for Moviie Studio and approved demos. They only
override saved organization/video settings when the URL also includes
preview=1. They do not persist changes and public embeds without preview=1
ignore them.
| Parameter | Type | Description |
|---|---|---|
preview=1 | literal | Enables temporary preview overrides for the current iframe load. |
playerKeyColor | hex color | Temporarily changes the primary player color. Encode # as %23 in hand-written URLs. |
captionFontColor | hex color | Temporarily changes caption text color. |
captionBackground | hex color | Temporarily changes caption background color. |
captionFontSize | number, 8-32 | Temporarily changes caption font size in pixels. |
airplay | boolean | Temporarily shows or hides AirPlay using non-inverted polarity. Public embeds should keep using disableAirplay. |
playbackRate | number, 1, 1.1, 1.25, or 1.5 | Temporarily changes the initial playback rate. |
search | boolean | Temporarily shows or hides in-player transcript search. The search UI still requires an indexed transcript and organization support. |
smartProgress | boolean | Temporarily shows or hides Smart Progress. The real seekbar remains hidden while Smart Progress is active. |
showEmbedBrand | boolean | Temporarily shows or hides the Moviie brand where branding can be displayed. |
disableIosPlayer | boolean | Temporarily requests the custom player experience on iOS where browser support allows it. |
speed0_25, speed0_5, speed0_75, speed1, speed1_25, speed1_5, speed1_75, speed2, speed2_25, speed2_5, speed2_75, speed3, speed3_25, speed3_5, speed3_75, speed4 | boolean | Temporarily enables or disables individual speed options in the speed menu. |
Examples
Autoplay muted in a hero banner
https://watch.moviie.ai/embed/VIDEO_ID?autoplay=true&muted=true&controls=false&loop=truePre-select Portuguese captions
https://watch.moviie.ai/embed/VIDEO_ID?lang=pt-BR&cc=pt-BRResume from a specific position
https://watch.moviie.ai/embed/VIDEO_ID?start=125Preview a custom player configuration
https://watch.moviie.ai/embed/VIDEO_ID?preview=1&playerKeyColor=%23FFFFE1&showSeekBackward=false&airplay=true&smartProgress=trueTips
- Unknown parameters are ignored: extra metadata you append for analytics tracking will not break the embed.
- The
controls=falsemode is meant for ambient backgrounds. Pair it withmuted=trueso playback is allowed by browsers, and consider providing your own controls via the Player API. - Forcing
qualityis useful for previews but can degrade the experience on slow networks. Preferautofor production. preview=1is for Studio and demos. Use organization defaults and per-video overrides for production customization that should persist.