Skip to main content
Embed settings live in Share → Embed and control how an embedded Tella video looks and behaves, from hiding the title and avatar to enabling autoplay or looping.

How to open embed settings

  1. Open your video in the Tella editor.
  2. Click Share in the top right.
  3. Click Embed.
Settings are on the left and a live preview on the right; changes update the preview and embed code in real time.

Embed size

  • Fixed width: The iframe has a fixed pixel width and height based on your video’s dimensions (default max 800px).
  • Responsive: The iframe fills its container’s width and keeps the correct aspect ratio, so it adapts to different screen sizes.

Lightweight embed

Turn on Lightweight embed in Share → Embed to show a thumbnail before viewers open the full player. It works with both Fixed width and Responsive, and suits hero sections or pages with several videos.
  • For a still thumbnail, turn off Autoplay and Animated thumbnail. Only the thumbnail image loads initially, not the Tella player.
  • With Animated thumbnail on, a muted five-second preview loops from your selected thumbnail frame. An uploaded custom thumbnail replaces this animated preview with a still image.
  • With Autoplay on, the first five seconds loop on mute until clicked. The Animated thumbnail option is hidden in this mode.
The player appears when viewers click the thumbnail. On desktop, hovering with a mouse loads the player invisibly without prebuffering video, so it can respond to the click. On touch devices, browser playback restrictions may require a second tap to start playback with sound. Show title, Show creator and Show overlay are hidden while Lightweight embed is on. Click Copy code and paste the complete HTML into your website. Lightweight mode needs the HTML’s click handlers; copying Link with options alone gives you a regular player embed. If your website blocks inline JavaScript event handlers (for example, a Content Security Policy without 'unsafe-inline', or a website builder that strips them), the thumbnail still works as a link: clicking it opens your video’s watch page in a new tab instead of playing it on your page.
If you change your video’s thumbnail later, copy and replace the lightweight embed code to update the thumbnail on your website.
Default: Off

Settings

Show title

Toggle the video title, creator details, and publishing date on or off. The publishing date appears when Publishing date is enabled in Viewer settings. When Show title is off, the embed shows just the video with a play button. Default: On

Show creator

Only visible when Show title is on. Turn it off to keep the title but hide the creator’s name and avatar. If Creator is turned off in Viewer settings, the creator stays hidden in every embed, whatever this setting says. Default: On

Show overlay

Only visible when “Show title” is turned off. Adds a dark overlay behind the play button so it’s easier to see against the video thumbnail. Default: On

Show “Record your own” button

Controls whether the “Record your own” call-to-action appears during playback. Default: On

Autoplay

In a regular embed, the video automatically starts playing (muted) when the page loads.
Browsers require autoplay videos to be muted; viewers can unmute the video.
With autoplay off, a regular embed loads the thumbnail and preloads only a short section of the video; the rest loads after the viewer presses play, so pages with several embeds load faster and use less data. Default: Off

Animated thumbnail

Shows a short animated preview clip before the viewer presses play. When off, the embed shows a static thumbnail. Default: On

Loop playback

The video restarts automatically when it reaches the end. Default: Off Controls whether a small link to watch the video on Tella appears in the player. Turn this off to remove Tella branding from the embed. Default: On

Domain restriction

This feature is only available on Tella Premium.
Enter one or more domains (comma-separated) and the embed only plays on those domains. See Domain restriction for embedded videos for details.

Using the embed code

Embed settings are stored in the embed URL itself, not on the server. If you change settings after embedding a video, copy the new embed code and replace it wherever the video is embedded.
There are two ways to use your settings:

Copy the embed code

Click Copy code at the bottom to copy the full embed HTML, and paste it into any website or CMS that supports HTML embeds. The “Link with options” section at the top shows a direct URL with your settings as query parameters. Use it when a platform only accepts a URL (not HTML), such as Notion or some CMS platforms.

URL parameters

You can set embed options by adding query parameters to the embed URL, without the embed modal or when generating embed URLs programmatically. Base URL format: https://www.tella.tv/video/{videoId}/embed Example: minimal, clean embed
This hides the title, the “Record your own” button, and the “Watch on Tella” link. Example: autoplay loop
This autoplays on mute and loops continuously with all UI elements hidden, like a background video.
Embedding several videos in a row, like lessons in a course? Use the Embed API to save the viewer’s captions and speed choices and pass them to the next embed with captions and speed.

oEmbed support

Tella is oEmbed compatible. Paste a Tella video link into a platform that supports oEmbed (such as Notion, WordPress, or Medium) and it displays your video with no embed code needed. You can paste the share link exactly as it appears in your browser, including links that end in /view. Tella also supports tella.video short links and links on your custom domain. Every Tella video page includes an oEmbed discovery tag pointing to Tella’s oEmbed endpoint, which returns the video’s title, author, thumbnail, dimensions, and a ready-to-use iframe.
Last modified on November 17, 2026