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

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

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


Did this page help you?