diff --git a/README.md b/README.md
index 03249bf..8ff8a44 100644
--- a/README.md
+++ b/README.md
@@ -114,3 +114,35 @@ These tools are meant for exploration and intuition, not absolute ground-truth j
- https://github.com/daredevilstudio/AI-upscaling-models/releases/download/PureVision/2x_PureVision.pth
- image compare node:
- https://github.com/quasiblob/ComfyUI-EsesImageCompare
+
+
+## ⚙️ Node Options
+
+
+
+
+The **Multi-Analysis Heatmap Node** provides several options to control how comparisons are made:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| **align_mode** | combo | `resize_b_to_a` | How to align the two input images:
• `resize_b_to_a` → resizes B to match A
• `center_crop_to_min` → crops both to the smaller overlap
• `pad_to_max` → pads smaller one with black pixels |
+| **color_map** | combo | `jet` | The color scheme for heatmaps:
• `jet` → rainbow style (bright = more difference)
• `grayscale` → black–white map |
+| **invert_ssim** | bool | `true` | Flip SSIM visualization so differences appear **bright** instead of dark. |
+| **ms_scales** | int | `3` | Number of scales for **MS-SSIM**. Higher = more robust but slower. |
+| **resid_gain** | float | `2.0` | Strength multiplier for the **Residual Visualization**. Higher = amplifies added/removed details more strongly. |
+| **fft_log_eps** | float | `1e-3` | Stabilization constant for FFT log spectrum. Adjust only if you see black/overblown spectra. |
+| **enable_lpips** | bool | `false` | Whether to compute the **LPIPS perceptual heatmap** (uses VGG16 features, slower, more VRAM). |
+| **denoise_sigma** | float | `1.0` | Standard deviation for Gaussian blur in **Denoiser Residual**. Controls how aggressively “noise” is extracted. |
+| **denoise_gain** | float | `2.0` | Amplification factor for the residual visualization in **Denoiser Residual**. |
+| **roundtrip_scale** | float | `0.5` | Downscale factor for **Round-Trip Stability** test. (0.5 = downscale by 2×, then upscale again). |
+| **roundtrip_kernel** | combo | `bicubic` | Resampling kernel for round-trip test. Options: `bicubic`, `bilinear`, `lanczos`. |
+
+---
+
+👉 **Tip:**
+- Start with defaults.
+- Enable `LPIPS` only if you want human-perception-like feedback.
+- Use `invert_ssim = true` for easier visual spotting (bright = problem).
+- Play with `resid_gain` and `denoise_gain` if maps look too weak/too strong.
+
+