> ## 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.

# Create motion graphics with Tella Motion

> Add a Tella Motion clip from Add clip, then ask the Tella Agent to build animated titles, shapes and graphics in it, or as overlays and b-roll.

Tella Motion adds animated graphics to your video: title cards, animated text, shapes and motion designs. To start one, choose **Add clip → New Tella Motion clip** under the timeline, then describe what you want to the Tella Agent and it builds it.

## Add a Tella Motion clip

1. Open your video in the Tella editor.
2. Click **Add clip** at the end of the clips under the preview.
3. Choose **New Tella Motion clip**.

Tella adds a blank 10-second clip named "Tella Motion" plus a number at the end of your video and opens it. Tella Motion clips have a rose card in the clip list, so you can tell them apart from your recorded clips.

## Build it with the Tella Agent

With the Tella Motion clip selected, describe what it should show in the Tella Agent chat on the right of the editor. For example:

* "Make an intro title card that says 'Quarterly update' and fades in word by word."
* "Add a dark background with three animated bullet points about our new features."
* "Make the title bigger and slow down the animation."

The agent edits the clip while you watch, and you can keep asking for changes until it looks right. See [Edit with the Tella Agent](https://www.tella.com/docs/help/editing/edit-with-the-tella-agent.md) to open the chat.

## Add motion graphics over your recording

You don't need a separate clip to use Tella Motion. Ask the agent to add a Tella Motion overlay or b-roll to one of your recorded clips, for example "Add an animated lower third with my name when I first appear" or "Show an animated chart while I talk about revenue." It plays over your recording or in place of it, timed to what you say.

## What you can do in a Tella Motion clip

A Tella Motion clip plays its own animation instead of a recording, so it has no transcript, layouts or cuts. You can still add overlays on top of it.

* In the toolbar on the left, **Setup**, **Library** and **Overlay** work. The other tools show "Not available in a Tella Motion clip".
* Click **Overlay** to add images, videos and text on top of the animation. They're timed from the start of the clip and appear above it in your shared and exported video.
* Use the playbar under the preview to play the clip or click to jump to a moment.
* Open the clip's menu in the clip list to **Rename**, **Duplicate** or **Delete** it, or drag it to move it.
* Open **Setup** to play the whole video, Tella Motion clips included.

> [!TIP]
>
> Tella Motion clips play in your shared and exported video like any other clip.

## Build Tella Motion from your own AI agent or code

AI agents connected to the [Tella MCP server](https://www.tella.com/docs/mcp-server.md), and scripts using the [Tella API](https://www.tella.com/docs/introduction.md), can build Tella Motion clips, overlays and b-roll with the same commands the Tella Agent uses. See [Tella Motion](https://www.tella.com/docs/mcp-tools/motion.md) in the developer docs for the tools, endpoints and every command they take.


## Related topics

- [Tella Motion](https://www.tella.com/docs/mcp-tools/motion.md)
- [Create a Tella Motion document](https://www.tella.com/docs/api-reference/tella-motion/create-a-tella-motion-document.md)
- [Tella Motion commands](https://www.tella.com/docs/mcp-tools/motion-commands.md)
- [Tella Motion effects](https://www.tella.com/docs/mcp-tools/motion-effects.md)
- [Create a video](https://www.tella.com/docs/api-reference/videos/create-a-video.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.