Embed & Stream

Embedding videos processed by Gumlet takes no time. Copy the embed code from the video CMS or video details page.

Get Embed code

To play videos on your website, blog, or any other CMS, Gumlet's embed code is an easy way to get started. It has a customizable player, video meta configuration, SEO snippet, and security features. You can configure your player settings here.

Here are the different ways to embed your videos quickly.

Video details page

On any video details page, the Embed Code button in the Publishing Options lets you customize your Embed code.

Embed Code Preview

<iframe width="960" height="540" 
        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 embed code above are for illustrative purposes only; you should adjust these properties to suit your needs 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 page load.	`true` or `false`	`false`
thumbnail	Provide a custom thumbnail image for the video embed.	Any valid image URL	Auto-generated thumbnail
background	Autoplay videos without any controls	`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`
loop	Play your videos in loop mode	`true` or `false`	`false`
start_high_res	Start video playback at the highest resolution.	`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`
playsinline	This parameter controls whether videos play in-line or full-screen on iOS. Valid values are: `true`: Results in fullscreen playback. This is currently the default value, though the default is subject to change. `false`: Results in inline playback for mobile browsers and for `WebViews` created with the `allowsInlineMediaPlayback` property set to `YES`.	`true` or `false`	`true`
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`
gm_user_id	User ID (custom tracking)	A string or integer	undefined
gm_user_name	User name (custom tracking)	A string	undefined
gm_user_email	User email (custom tracking)	A string	undefined
gm_custom_data_1	Custom Data 1	A string	undefined

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

Advanced parameters

Here is a list of parameters to make your player customizable by enabling specific actions on the control bar. You can also customize the player using the player customizer here .

Query Parameter	Description	Possible Values	Default Value
disable_player_controls	Disables all the player controls except the large play button in the center of the player.	`true` or `false`	`false`
disabled_player_control	If `disable_player_controls` is not used, you can disable one or more player controls. You can add this parameter multiple times, each with a different value. For example, to disable the progress bar and the cast button, you can send: `?disabled_player_control=cast &disabled_player_control=progress`	`rewind`, `fast-forward`, `play`, `progress`, `pip`, `current-time`, `duration`, `mute`, `volume`, `cast`, `captions`, `airplay`, fullscreen, ``settings,	undefined
audio_track_language	for pre-selecting the default audio language (if you have multiple), this accepts the ISO language code listed here	`en` or `es` or others	original source language or `en`
caption_language	for pre-selecting the default captions language (if you have multiple), this accepts the ISO language code listed here	`en` or `es` or others	original source language or `en

📹
You can get the MP4 and other plaback URLs
On the asset details page, click on Publishing Options > URLs, you will get the access to .mp4, .m3u8, .mpd URLs as use as per your need.

Different type of URLs — Different types of URLs

📘
Are you a developer or using APIs?
If yes, use the asset ID from the API response with the iframe code here.

🚧
Are you using WordPress?
If yes, use the Gumlet Video WordPress plugin. Learn more about plugin here.
If you do not use the plugin, some player features may not work as WordPress removes the additional attributes from the iframe embed code.

📘
Are you using Shopify or any other ecommerce platform?
Use background=1 in the query parameter in the source and your video will auto-play like native experience without any controls.
Sample iframe src: https://play.gumlet.io/embed/64be6a1705ab8a164db198a5?background=true

📘
How to create time-limited video preview URLs?
There are two ways, if you want to use APIs to generate limited time embed code or preview page URL, refer to the Signed URL here.
Otherwise, you can generate a secure expiry URL from the dashboard. Read more here.