EmbeddingURL parameters
URL parameters
Configure the Moviie Player at load time using query string parameters.
Every option that affects the initial state of the player is exposed as a
URL parameter on the embed URL. Parameters compose — append them with &
in any order.
Reference
| Parameter | Type | Default | Description |
|---|---|---|---|
autoplay | 0 or 1 | 0 | Starts playback as soon as the player is ready. Most browsers require muted=1 to honour this. |
muted | 0 or 1 | 0 | Loads the player muted. |
loop | 0 or 1 | 0 | Restarts playback automatically after ended. |
controls | 0 or 1 | 1 | Hides the built-in controls when set to 0. |
start | number (seconds) | — | Starts playback at the given offset. |
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. |
Examples
Autoplay muted in a hero banner
https://watch.moviie.ai/embed/VIDEO_ID?autoplay=1&muted=1&controls=0&loop=1Pre-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=125Tips
- Unknown parameters are ignored — extra metadata you append for analytics tracking will not break the embed.
- The
controls=0mode is meant for ambient backgrounds. Pair it withmuted=1so 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.