Embed Videos
A complete guide on embedding Gumlet videos on your webpage.
It's very easy to embed Gumlet processed video on your webpage. All you need to do is to copy embed code from asset page and paste it in on your webpage.
Gumlet embed code has following structure.
<iframe style="width:100%;aspect-ratio: 1200 / 675;"
src="https://api.gumlet.com/v1/video/embed/{{asset_id}}"
title="Gumlet video player"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen>
</iframe>
Here you must replace {{asset_id}}
in src
to actual asset id of the video. There are many parameters you can pass to that URL to customise your embedded video. It's also advised to change aspect-ratio
property in the style
tag to actual aspect ratio of video for best viewing experience.
All parameters must be passed as query parameter in above URL e.g. https://api.gumlet.com/v1/video/embed/653abcd828dcab?preload=true
Parameter Reference
Query Parameter | Description | Possible Values | Default Value |
---|---|---|---|
preload | Preload video even before user clicks play button. It allows for instant playback of video. | true or false | false |
autoplay | Enable or disable video autoplay. Please note, autoplay videos will have their audio disabled on all browsers. | true or false | false |
thumbnail | Provide custom thumbnail image for video embed. | Any valid image URL | Default thumbnail created by us. |
vast_tag_url | VAST tag that should be used to display ads while playing this video | Any valid VAST tag URL | undefined |
start_high_res | Start video playback with highest resolution for best quality at start. | true or false | false |
player_color | Theme color for the player | Any hex color value | #6658EA |
gm_property_id | Gumlet insights property id in which the viewer analytics should be pushed. | Any valid property id | Default property for your account. |
token | DRM playback token. This must be passed if the video is DRM encrypted. | Generated one time token for DRM playback. | undefined |
expires | DRM token expiry timestamp in milliseconds since epoch. This must be passed if video is DRM encrypted. | Expiration timestamp for the DRM playback token. | undefined |
logo_url | URL of logo to display during video playback. | Any valid image URL. | undefined |
logo_height | Logo height in pixels. | Any pixel height. | 100px |
logo_width | Logo width in pixels. | Any pixel width. | 100px |
logo_position | Logo position in player. | top , topleft , topright , right , bottomright , bottom , bottomleft , bottomleft , left | bottomright |
Updated about 1 month ago