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. The settings are saved in the embed code, so copy it again after any change.

​
How to open embed settings

  1. Open your video in the Tella editor.
  2. Click Share in the top right.
  3. Click Embed.
You’ll see a settings panel on the left and a live preview on the right. Changes update the preview and the embed code in real time.

​
Embed size

Choose how the embed is sized:
  • Fixed width: The iframe has a fixed pixel width and height based on your video’s dimensions (default max 800px). Use this when you want a specific size.
  • Responsive: The iframe fills the width of its container and maintains the correct aspect ratio. Use this for layouts that need to adapt 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 is useful for website 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 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. Your website must allow inline JavaScript event handlers for the lightweight code to work.
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, useful for a cleaner, more minimal look. 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. Turn this off for a distraction-free viewing experience. Default: On

​
Autoplay

In a regular embed, the video automatically starts playing (muted) when the page loads. This is useful for landing pages or product demos where you want the video to grab attention immediately.
Browsers require autoplay videos to be muted. The video will start playing silently, and viewers can unmute it manually.
In a regular embed with autoplay off, Tella loads the thumbnail first and preloads only a short section of the video. The rest loads after the viewer presses play, helping pages with several embeds load faster and use less data. Default: Off

​
Animated thumbnail

Show an animated preview (a short clip) of the video before the viewer presses play. When disabled, the embed shows a static thumbnail instead. Default: On

​
Loop playback

The video automatically restarts when it reaches the end. Useful for short product demos, background videos, or presentations that should play continuously. 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.
Restrict where your embed can be played by entering one or more domains (comma-separated). When enabled, the video only plays on the specified 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’ve already embedded your video on a website and later change your settings, you’ll need to copy the new embed code and update it wherever the video is embedded.
Once you’ve configured your settings, you have two ways to use them:

​
Copy the embed code

Click Copy code at the bottom to copy the full embed HTML. 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 applied as query parameters. This is useful when a platform only accepts a URL (not HTML), such as Notion or some CMS platforms.

​
URL parameters

You can also customize the embed by adding query parameters directly to the embed URL. This is useful when you want to set options without using 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 for a clean, distraction-free player. Example: autoplay loop
This creates a video that autoplays on mute and loops continuously, with all UI elements hidden, ideal for a background video effect.

​
oEmbed support

Tella is oEmbed compatible. When you paste a Tella video link into a platform that supports oEmbed (such as Notion, WordPress, or Medium), the platform automatically fetches the embed details and displays your video, with no manual 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. This works because every Tella video page includes an oEmbed discovery tag that points to Tella’s oEmbed endpoint. The endpoint returns the video’s title, author, thumbnail, dimensions, and a ready-to-use iframe.
Last modified on October 2, 2026