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 ParameterDescriptionPossible ValuesDefault Value
preloadLoad the video even before the user clicks the play button. It enables instant playback of the video.true or falsefalse
autoplayPlays the video automatically on the page load.true or falsefalse
thumbnailProvide a custom thumbnail image for the video embed.Any valid image URLAuto-generated thumbnail
vast_tag_urlVAST tag that should be used to display ads while playing this videoAny valid VAST tag URLundefined
start_high_resStart video playback with the highest resolution at the start.true or falsefalse
player_colorThe theme color for the playerAny hex color value#6658EA
gm_property_idGumlet insights property id to which the viewer analytics needs to be loggedAny valid property idDefault Property ID of your account.
tokenDRM playback token. This must be passed if the video is DRM encrypted.Generate a one-time token for DRM playback.undefined
expiresDRM 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_urlURL of the logo to display during video playback.Any valid image URL.undefined
logo_heightLogo height in pixels.Any pixel height.100px
logo_widthLogo width in pixels.Any pixel width.100px
logo_positionLogo position in the player.top, topleft, topright, right, bottomright, bottom, bottomleft, bottomleft, leftbottomright

Note: autoplay videos will have their audio disabled on all browsers.


What’s Next