> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Customize embed settings
> Control how your embedded Tella video looks and behaves — hide the title, autoplay, loop, and more.
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
### "Watch on Tella" link
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](https://tella.com/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](/help/sharing/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.
### Copy the link with options
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`
| Parameter | Values | Default | Description |
| ---------- | ---------- | ------- | ------------------------------------------------------------ |
| `title` | `0` or `1` | `1` | Show or hide the title and creator avatar |
| `b` | `0` or `1` | `1` | Show or hide the "Record your own" button |
| `a` | `0` or `1` | `1` | Show or hide the animated thumbnail preview |
| `loop` | `0` or `1` | `0` | Enable or disable loop playback |
| `autoPlay` | `true` | Off | Auto-play the video (muted) on load. Omit to disable |
| `muted` | `0` or `1` | `0` | Start the video muted |
| `t` | Seconds | `0` | Start playback at a specific time (e.g., `t=30`) |
| `wt` | `0` or `1` | `1` | Show or hide the "Watch on Tella" link |
| `o` | `0` or `1` | `1` | Show or hide the dark overlay behind the play button |
| `fullSize` | `true` | On | Fill 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.