# Backdrop

> A coloured box behind nodes.

A coloured box behind nodes. Dragging its title bar moves the nodes on it; drag the bottom-right corner to resize. Appearance is Fill (a coloured box) or Border (an outline only); z_order sets which backdrop sits in front.

| Node | Backdrop |
|---|---|
| Menu | Other › Backdrop |
| **Names in each format** | |
| .oink comp (JSON) | `"type": "OC_N_backdrop"` |
| .nk script | `BackdropNode` ([how .nk import works](/docs/nuke-users/nk-import)) |
| Python | `nuke.createNode("BackdropNode")` |
| Assistant (MCP) | `create_node(type="Backdrop")` |
| Tab search | `backdrop` |

## Inputs and outputs

No image inputs or outputs.

## Knobs

Panel tab **Backdrop**, in panel order.

| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
| `bd_label` | label | text |  |  |  |  |
| `note_font_size` | font size | float | `20` | 6 to 100 (integer) | `note_font_size` |  |
| `tile_color` | tile color | colour ×3 | `0.557, 0.557, 0.22` | 0 to 1 |  |  |
| `appearance` | appearance | menu | `Fill` | Fill, Border | `appearance` |  |
| `bd_width` | width | float | `400` | 40 to 4000 (integer) | `bdwidth` |  |
| `bd_height` | height | float | `240` | 30 to 4000 (integer) | `bdheight` |  |
| `z_order` | z order | float | `0` | -10 to 10 (integer) | `z_order` |  |

### Other knobs (Python, .nk and the assistant; not on the panel)

| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
| `gl_color` | Viewer Controls Color | float ×3 | `0, 0, 0` | 0 to 1 |  |  |
| `postage_stamp_frame` | Static Frame | int | `1` | -2147483648 to 2147483647 |  |  |
| `lifetimeStart` | Lifetime Start | int | `0` | -2147483648 to 2147483647 |  |  |
| `lifetimeEnd` | Lifetime End | int | `100` | -2147483648 to 2147483647 |  |  |
| `useLifetime` | Use Lifetime | boolean | `false` |  |  |  |
| `cached` | Cached | boolean | `false` |  |  |  |
| `bookmark` | Bookmark | boolean | `false` |  |  |  |
| `dope_sheet` | Dope Sheet | boolean | `false` |  |  |  |
| `clone_group` | Clone Group | string |  |  |  |  |
| `link_source` | Link Source | string |  |  |  |  |
| `link_overrides` | Link Overrides | string |  |  |  |  |
| `split_views` | Split Views | string |  |  |  |  |

## Knob names in .nk scripts

| .nk knob | Knob here |
|---|---|
| `bdwidth` | `bd_width` |
| `bdheight` | `bd_height` |

Other .nk knobs use the same name here. See [.nk import](/docs/nuke-users/nk-import).


---
Sources: opencomp_core/nodes/utility/backdrop.py, opencomp_electron/src/components/properties/knobSchema.ts, opencomp_core/nodes/help/backdrop.md, opencomp_core/nk/mapping.py