Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tella.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

When you embed a Tella video on a website, you can customize its appearance and behavior. These settings let you control what viewers see — 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.
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 iframe 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.

​
Settings

​
Show title

Toggle the video title and creator avatar on or off. When hidden, 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

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.
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 iframe 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
ParameterValuesDefaultDescription
title0 or 11Show or hide the title and creator avatar
b0 or 11Show or hide the “Record your own” button
a0 or 11Show or hide the animated thumbnail preview
loop0 or 10Enable or disable loop playback
autoPlaytrueOffAuto-play the video (muted) on load. Omit to disable
muted0 or 10Start the video muted
tSeconds0Start playback at a specific time (e.g., t=30)
wt0 or 11Show or hide the “Watch on Tella” link
o0 or 11Show or hide the dark overlay behind the play button
fullSizetrueOnFill the entire container. Omit to scale to video dimensions
Example — minimal, clean embed: 
https://www.tella.tv/video/your-video-id/embed?title=0&b=0&wt=0
This hides the title, the “Record your own” button, and the “Watch on Tella” link for a clean, distraction-free player. Example — autoplay loop: 
https://www.tella.tv/video/your-video-id/embed?autoPlay=true&loop=1&title=0&b=0&wt=0
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 — no manual embed code needed. 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.