diff --git a/README.md b/README.md
index 43b7514..bf7e353 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,10 @@ git clone https://github.com/stuttlepress/ComfyUI-Wan-VACE-Prep
 - [VACE Extend](#vace-extend)
 - [Load Videos From Folder (Simple)](#load-videos-from-folder-simple)
 
+## Experimental Nodes
+
+- [Wan VACE Inpaint](#wan-vace-inpaint)
+
 ### VACE Outpaint
 
 Prepares a video for outpainting using an interactive canvas widget. Position and size an output window over your source frames. Regions outside the source become the outpaint area. Builds a VACE control video and mask ready for generation.
@@ -203,6 +207,34 @@ See the VHS Meta Batch Manager node documentation for more information.
 |-|-|
 | images | Concatenated image batch ready for video creation |
 
+---
+## Experimental
+
+Stuff here is new and has not been thoroughly tested. Inputs, outputs, and behavior may change in future releases without notice.
+
+### Wan VACE Inpaint
+
+> **Experimental** - new and not well tested. Behavior and interface may change.
+
+Prepares control video and mask for inpainting. An optional reference image can be input as a context frame to guide generation.
+
+**Parameters:**
+
+| Parameter | Default | Description |
+|-|-|-|
+| video | | Source video frames (IMAGE) |
+| mask | | Inpaint mask. White (1) marks regions to regenerate, black (0) preserves the original. Can be a single frame (broadcast to all frames) or a per-frame sequence. |
+| reference_image | *(optional)* | A single image prepended as a context frame with mask=0. Resized automatically if dimensions differ from the video. |
+
+**Outputs:**
+
+| Output | Description |
+|-|-|
+| control_video | VACE control video input. Masked pixels replaced with gray (0.5); reference frame prepended if supplied. |
+| control_mask | VACE control mask input. Matches control_video length; reference frame slot is fully black (0). |
+| width, height | Video dimensions (must be divisible by 16) |
+| length | Frame count (video frames + 1 if reference image provided) |
+
 ---
 
 ## Technical Notes
@@ -213,6 +245,8 @@ See the VHS Meta Batch Manager node documentation for more information.
 
 **Nodes 2.0 renderer.** These nodes have not been tested under ComfyUI's Nodes 2.0 renderer and may or may not work correctly with it. Testing and support will be added sometime after ComfyUI publishes documentation for node developers to work from.
 
+---
+
 ## License
 
 MIT License. Feel free to use, modify, and distribute.