Embed Videos
A complete guide on embedding Gumlet videos on your webpage.
Embedding videos processed by Gumlet is straightforward. Copy the embed code from the video collection or asset management page.
Gumlet embed code has the following structure.
<iframe width="1200" height="675"
src="https://play.gumlet.io/embed/{{asset_id}}"
title="Gumlet video player"
frameBorder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; fullscreen">
</iframe>
Replace the {{asset_id}}
in the src
above with the asset id of the video you want to embed. The height and width mentioned in the above embed code are for representational purposes only; you shall change this property to fit your need for the best viewing experience.
Customize your embedded video by passing query parameters along with the URL.
For example:https://play.gumlet.io/embed/{{asset_id}}?preload=true&player_color=#F0F0F0
The above example will preload your video and change your player color to#F0F0F0
.
Parameter Reference
Here is the list of all the available parameters to configure your player and video settings.
Query Parameter | Description | Possible Values | Default Value |
---|---|---|---|
preload | Load the video even before the user clicks the play button. It enables instant playback of the video. | true or false | false |
autoplay | Plays the video automatically on the page load. | true or false | false |
thumbnail | Provide a custom thumbnail image for the video embed. | Any valid image URL | Auto-generated thumbnail |
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 the highest resolution at the start. | true or false | false |
player_color | The theme color for the player | Any hex color value | #6658EA |
gm_property_id | Gumlet insights property id to which the viewer analytics needs to be logged | Any valid property id | Default Property ID of your account. |
token | DRM playback token. This must be passed if the video is DRM encrypted. | Generate a one-time token for DRM playback. | undefined |
expires | DRM token expiry timestamp in milliseconds since epoch. This must be passed if a video is DRM encrypted. | Expiration timestamp for the DRM playback token. | undefined |
logo_url | URL of the 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 the player. | top , topleft , topright , right , bottomright , bottom , bottomleft , bottomleft , left | bottomright |
Note: autoplay videos will have their audio disabled on all browsers.
Updated about 13 hours ago