# Add text overlay (`add_text_overlay`)
> Adds a text overlay (a title card, lower-third, end slate or call-to-action) with timing in seconds and optional styling.
- Area: [Studio editing](https://mcp.dadan.io/tools/studio-editing.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (the explicit overwrite_original:true path irreversibly replaces the original's render)
- AI credits: yes
- Available on read-only connections: no

## Example prompt
"Put a title card reading 'Q3 Recap' on the first five seconds"

## Parameters
- `video_id` (string, required): The video's guid.
- `text` (string, required): The text to display.
- `subtitle` (string): Secondary line (e.g. the role line of a lower-third).
- `preset` (string): Layout preset: title-card (default), lower-third, end-slate, or cta.
- `position` (string): Named position: center, top, bottom, top-left, top-right, bottom-left, bottom-right.
- `start_seconds` (number): When the text appears, in seconds. Omit for the start of the video.
- `end_seconds` (number): When the text disappears, in seconds. Alternative to duration_seconds.
- `duration_seconds` (number): How long the text stays visible, in seconds. Alternative to end_seconds.
- `font_family` (string): Font family, e.g. 'Montserrat'.
- `font_size` (integer): Font size in points, e.g. 48.
- `text_color` (string): Text color, e.g. '#FFFFFF'.
- `background_color` (string): Text box background color, e.g. '#000000'.
- `animation` (string): Enter animation, e.g. 'fade' or 'slide-up'.
- `overwrite_original` (boolean): true = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

## Description for AI assistants
Add a text overlay to a video: title cards, lower-thirds, end slates, or CTAs (preset: title-card (default), lower-third, end-slate, cta). Timing in SECONDS via start_seconds plus end_seconds OR duration_seconds (not both). Optional styling: position (center, top, bottom, corners), font_family, font_size, text_color, background_color, animation (e.g. fade, slide-up). overwrite_original default false = renders a NEW copy, original untouched; true OVERWRITES the original's render. Returns a processing job — poll get_job_status; rendering takes a while.


## Used in these prompts

- Send a branded video pitch with a CTA (Sales): "Take my product walkthrough [link], add a title card that says "[Prospect], here's your 3-minute tour", set a "Book a call" button near the end (it replaces any existing button), and give me a one-click share link to send."
- Clip the best moment for social (Marketing): "Find the strongest 45 seconds in my talk [link], trim to just that moment, reframe it vertical for Reels and TikTok, and add a bold text overlay of the key quote."
- Turn a recurring question into a help clip (Success & Support): "Take my how-to video [link], add chapters for each step and a title card, then make it public and give me the embed code for our help center."
- Put your brand on every clip (Creators & Social): "Add my logo ([logo image link]) as a watermark top-right on [link], and a lower-third with my name and handle for the first five seconds."
Canonical page: https://mcp.dadan.io/tools/add-text-overlay
