# Change the background

> Add a background layer in Nosmai Studio to blur what is behind the person, or replace it with an image, a video, or a solid colour. Studio separates the person from the background each frame and composites your choice behind them. Use it for clean backdrops, branded scenes, or a blurred portrait look.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/studio.txt

Product: Nosmai Studio
Group: studio-guides
Source: https://nosmai.com/docs/studio/guides/change-the-background/



## Overview

A background layer changes what is behind the person. Studio separates the person
from the background each frame and composites your choice behind them: a blur, an
image, a video, or a solid colour.

**Product:** Nosmai Studio · **Platform:** macOS, Windows · **Updated:**
6 October 2026 · **Reading time:** 7 minutes

## Prerequisites

- A project open in the editor.
- For an image or video background, a file in a supported format.

## Add a background

1. In the Layers panel, press **+**, then choose a background kind under
   **Behind you**: Background blur, Background image, or Background video.
2. For an image or video, pick the file, or add the layer and choose it in the
   inspector.

## Set it up

Select the background layer to open its **Backdrop** inspector:

- **Mode**: Blur, Image, Video, or Colour.
- **On**: turn the backdrop on or off.
- **Blur strength**: how strong the blur is (Blur mode). The default is `15`.
- **Edge softness**: how softly the person's edge blends into the background. The
  default is `0.15`.
- **Colour**: a colour picker (Colour mode).

Every edit keeps the background block and its generated render pass in sync, so you
do not manage them separately.

## Verify it worked

- The background changes behind the person in the preview.
- The person stays sharp while the background blurs or is replaced.
- Switching mode (Blur, Image, Video, Colour) changes the backdrop live.

## Common problems

| What you see | Why | Fix |
| --- | --- | --- |
| The person's edge looks harsh | Edge softness is too low | Raise edge softness until the blend looks natural |
| The Image or Video mode is disabled | No image or video asset is chosen | Choose a file for that mode in the inspector |
| The background does not change | The backdrop is off, or no person is detected | Turn the backdrop on, and make sure a person is in view |
| A control labelled "Fit" or "Colour spill" does nothing | Those controls are not wired in this version | Use blur strength, edge softness, and mode, which are the working controls |

## Next steps

- [Colour and LUTs](/docs/studio/guides/colour-and-luts/)
- [Add a layer](/docs/studio/guides/add-a-layer/)
- [Check performance](/docs/studio/guides/check-performance/)

## Reference

- [File formats](/docs/studio/reference/file-formats/)
