Add media (B-roll)

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.

Media lets you replace your screen recording with an image or video clip for part of your Tella video — what video editors call B-roll. Use it to cut to a product screenshot, a stock video, a diagram, or an AI-generated visual while your camera keeps you on screen.

​

What you can use as media

Anything you put in the Media slot of a layout becomes your B-roll for that section. You have three sources:

• Upload — drop in an image (PNG, JPEG, WebP, GIF) or a video file (MP4, MOV, WebM, etc.) from your computer.
• Media library — pick from media you’ve uploaded or generated before. Items are organized into Personal (only you) and your Workspace library (shared with teammates).
• Generate with AI — describe what you want and Tella generates an image for you. You can attach a reference image to steer the look.

​

Add media to a layout

Media replaces the Screen Recording in a layout, so it lives inside a layout section on top of your base layout. You add it the same way you’d customize any layout:

1. Open your video in the editor and select the clip you want to work on.
2. Move the playhead to where you want the cut to media to start, then click Add Layout in the Layouts panel. This creates a new section on top of the base layout. (See Multi-layouts for more on adding sections.)
3. With the new section selected, open the Customize panel in the sidebar. Under the Screen section, find the Source dropdown.
4. Switch Source from Screen Recording to Media.
5. The Media row appears. Click Browse media to open the Media Library and pick an item, upload a new one, or generate one with AI.

That section of your video now shows the media instead of your screen recording, while the rest of the layout — your camera, background, borders, and so on — stays the same.

​

The Media Library

Clicking Browse media opens the Media Library panel. From here you can:

• Search — type to filter by name across your Personal and Workspace libraries.
• Upload — drop files into the panel or use the upload button. Each upload is added to your Personal library by default.
• Move between Personal and Workspace — drag a tile from one section to the other to share it with your workspace, or pull it back to keep it private.
• Reorder — drag tiles within a section to put your most-used media at the top.
• Rename, download, or delete — open the tile’s menu (three dots) to manage existing items.

Items in your Workspace library are visible to everyone in your workspace and stay available across all of your videos.

​

Generate media with AI

At the top of the Media Library panel, the Generate section lets you create an image with a prompt:

1. Describe what you want in the prompt box, e.g. “a soft pastel gradient with abstract shapes” or “a person typing on a laptop, warm lighting.”
2. (Optional) Click the photo icon at the bottom-left of the prompt box to add a reference image. Tella uses it as visual inspiration. You can upload a PNG, JPEG, or WebP up to 10 MB. The selected reference image appears as a thumbnail inside the prompt composer — click the × to remove it. Use the ⋯ menu next to the photo icon to pick Current image as reference and iterate on whatever’s already in the slot.
3. Click Generate. The new item appears as a placeholder while it’s processing and turns into a real tile when it’s done.

Generated media is saved to your Personal library so you can reuse it in other videos.

​

Combine media with layout styles

Media works with all of Tella’s layout styles, so you can stage it however you like:

• Camera Bubble — your media fills the frame with your camera as a small bubble in a corner.
• Side-by-side — camera and media split the frame.
• TV Presenter — your camera takes the spotlight with the media floating alongside.
• Screen only — show just the media, full-frame, with no camera.

Pick the style from the layout picker just like you would for any other layout. The Source = Media setting and your chosen media stay attached as you switch styles, so you can experiment freely.

​

Use media across multiple sections

Because each layout section has its own source, you can cut between camera and different B-roll throughout a clip. A common pattern:

1. Start the clip on your base layout (just you and your screen recording).
2. Add a section, set the Source to Media, and pick a product screenshot.
3. Add another section later in the clip, set the Source to Media, and pick a different image or short video.
4. The base layout continues between sections, so you cut back to yourself in between.

Transitions between sections work the same as for any multi-layout video — see Multi-layouts for how to adjust them.

​

Auto Layouts and media

Auto Layouts can add image B-roll automatically based on what you’re saying. When you generate auto layouts, Tella may insert media sections with AI-generated images that match the content of your clip. You can swap, regenerate, or remove any of these the same way you’d edit any other media section.

​

Tips

• Match your aspect ratio. Tella will fit your media to the layout’s frame, but media shot or generated in the same orientation as your canvas (landscape, portrait, square) looks best.
• Keep B-roll short. Cutting to media for 2–5 seconds at a time keeps the pace lively.
• Reuse media across videos. Anything in your Personal or Workspace library is available in every video — no need to re-upload or re-generate.