# Match colors to a reference image

Use this guide when shots in your story do not look like they belong together. You will make one picture or clip take on the colors of a reference image.

## Before you start

You need an image or video on the canvas, and a second image with the look you want. A still from another shot of the same scene works well.

## Match the colors

1. Add **Color correction** from **Toolbox**, under **Editing**.
2. Wire the picture or clip you want to change into the **File** input.
3. Wire the reference image into the **Reference** input.
4. Look at the card. A **Match** menu and a **Strength** slider show above the color sliders.
5. Choose a method in **Match**:
   - **Mean** moves the average and the spread of each color channel to the reference. Use it for a gentle change.
   - **Histogram** moves the whole spread of each color channel to the reference. Use it for a closer match.
6. Set **Strength** from 0 to 100. At 100 the match is full. At 0 the picture does not change.

You should see the matched picture on the card after a short wait. Download and the next node receive the matched file.

For a clip, Canvas reads the colors of the middle frame once. Every frame then gets the same change, so the colors do not flicker.

## Fine-tune the result

The sliders work on the matched picture. Use **Exposure**, **Contrast** and the other sliders to adjust it further. **Reset** sets the sliders back to zero. It does not remove the match.

To stop matching, remove the wire from **Reference**, or set **Strength** to 0.

## Read the histograms

Under the picture, the card shows two histograms: **Input** for the file wired into the card, and **Result** for the file Download and the next node receive. Each one draws the brightness (filled) and the red, green and blue channels (lines) from dark on the left to bright on the right. The text under each says how much of the picture is pure black and pure white.

- A large share of black or white means detail is lost there. Lower **Exposure** or **Highlights** for white, and raise **Shadows** for black.
- **Result** says **Waiting for the bake** until the new file is ready.
- For a clip, both histograms read the middle frame, the same frame the match reads.

An agent reads the same numbers from `media_measure` with the `color` group: `histogram` holds 64 bins each of luma, red, green and blue, and the black and white shares.

## Check and fix

If the card shows the original colors, wait for the bake to finish. If the card says the file did not save, select **Retry**.

If the colors look too strong, lower **Strength** or change **Match** to **Mean**.

**Reference** takes only an image. To match a clip to another clip, first take one frame from the reference clip with **Extract Frame**, then wire that frame into **Reference**.

## Ask your agent

> Help me match the colors of my second shot to my first shot. First, inspect the File for the two video nodes and a frame I can use as a reference. Explain the proposed changes and ask before you change any node.

Your agent can wire **Reference** and set the match settings. `node_run` bakes a matched still or clip on the server. For a clip it reads the same middle frame Canvas reads, so both give the same colors. A Reference that is not a PNG or JPEG still (a clip, WebP or AVIF) is refused with `reference-not-picture`.

Review the matched picture on the card before you continue.

## Related pages

- [Tools](/docs/mcp/tools)
- [Stories](/docs/concepts/stories)

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