# Layer one picture or clip over another with Composite

Use this guide when a shot needs a logo on top, a subject on a new background, or two pictures blended together. You will make one finished picture or clip from what you wire in.

Base and Overlay each take a picture or a clip. With a clip on either one, the result is a clip ([Layer a clip](#layer-a-clip)).

## Before you start

You need a picture in Canvas for **Base**. Add a second picture for **Overlay**, or an AI Mask node for **Region**. Composite is in **Toolbox**, under **Editing**.

## Place a picture over another

1. Add **Composite** from **Toolbox** &gt; **Editing**.
2. Connect the picture underneath to **Base**. The result is the size of this picture.
3. Connect the picture on top to **Overlay**.
4. Set **Position X**, **Position Y**, **Scale**, **Rotation** and **Opacity** on the card. **Position X** and **Position Y** place the centre of the Overlay. **Scale** is a multiple of the Overlay's own size.
5. Choose **Blend** to mix the colors, for example **Multiply** or **Screen**. **Normal** applies no mix.
6. Choose **Operator** to set how the transparent parts combine. **Over** (the default) puts the Overlay on top.

You should see the card's preview change with each setting. Download and the next node receive the finished picture. **Reset** returns every setting to its default.

## Limit the Overlay to a region, or cut a subject out

Connect an AI Mask node to **Region**.

- **With an Overlay,** the Overlay shows only inside the region.
- **With no Overlay,** the region cuts **Base** out, and the outside becomes transparent. Set **Background** to fill it with a color.

## Layer a clip

Connect a clip to **Base** or **Overlay**. The result is a clip the size of Base. It runs as long as Base, or as long as the Overlay when Base is a picture. The card's preview shows the first frame.

- Set **Overlay from** and **Overlay to**, in seconds, to choose when the Overlay shows. Leave **Overlay to** empty to show it to the end.
- Set **Overlay sound** to **Mix with Base** to keep the Overlay's sound. **Drop** (the default) keeps only Base's sound.
- A clip cannot be transparent. What stays transparent becomes the **Background** color, or black when none is set.
- A clip needs an even width and height. When Base has an odd width or height, the result gains one black column or row at the right or bottom edge. Every Base pixel stays where it was, so a 161x121 Base makes a 162x122 clip.
- A Region on a clip must come from an AI Mask traced from Base. A Region traced from the Overlay is refused.
- Under a clip, a Base picture must have no see-through pixels. A cut-out PNG on Base is refused; use a picture with no transparency, or a clip.

## Check and fix

A wired Overlay or Region that is not ready holds the result, and the card bakes when it is ready. With no Overlay, no Region and no Background, Base passes through unchanged. If the card refuses a Region on a clip, trace the AI Mask from Base. If it refuses a see-through Base picture under a clip, wire a picture with no transparency.

## Ask your agent

> Help me put this logo on my opening picture. First, inspect the File and find both pictures. Wire them into a Composite node, set the position and scale, and run it with node_run.

Your agent runs the node with `node_run`. A missing Base ends with `node-input-missing`, a Region with no track ends with `node-input-not-ready`, and a Region it cannot place, or a see-through Base picture under a clip, ends with `node-input-unsupported`. With a clip, `node_run` answers a `runId`; poll `node_run_status` until it reports `done`.

## Related pages

[Builder guide](/docs/mcp/build), [Stories](/docs/concepts/stories) and [Find every object with AI Mask](/docs/guides/edit-media).

---
Source commit: 9ccaa86d41d7 · Build date: 2026-11-17T03:27:39.423Z
