Embed Videos

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`