Claude
da9c2eba5a
Bug: When user selected "Region 1" and edited box position, it was actually moving Region 2's box instead. Root Cause: transformFunc was using region selector value directly as array index without converting from 1-based UI to 0-based array indexing. - Region selector displays: "Region 1", "Region 2", etc. (1-based for users) - Behind the scenes: array[0], array[1], etc. (0-based for storage) Fix: In transformFunc, subtract 1 from region selector value before using as array index: regionSelectorValue = 1 → arrayIndex = 0 → updates array[0] (Region 1) regionSelectorValue = 2 → arrayIndex = 1 → updates array[1] (Region 2) Now editing "Region 1" box correctly updates the first region in the array.
ComfyUI Regional Conditioning
Control different parts of your image with separate prompts using visual box drawing.
Quick Start
- Install: Clone to
ComfyUI/custom_nodes/or use ComfyUI Manager - Add Node: Search for "Regional Prompter"
- Connect: CLIP → Regional Prompter → Sampler
- Draw: Use canvas to position regions, type prompts
- Generate: Connect to your sampler and run
Nodes
Regional Prompter (Mask-Based)
For: Flux, Chroma, SD3, SD3.5, Qwen-Image
Inputs:
clip: CLIP from checkpointwidth/height: Must match your latent dimensionssoften_masks: Feathering at edges (recommended ON)background_prompt: Scene descriptionregion1-4_prompt: Region-specific prompts
Tips:
- Use CFG 1.0-3.5 with Flux (higher = blur)
- Keep to 3-4 regions max for Flux/Chroma
- Default strength 0.8 works well
Regional Prompter (Area-Based)
For: SD1.5, SD2.x, SDXL
Same interface, uses area-based conditioning instead of masks.
Canvas Controls
- index: Select which region to edit
- box_x, box_y: Region top-left position
- box_w, box_h: Region dimensions
- strength: Conditioning strength (0-10, default 0.8)
Example Workflow
Checkpoint Loader
├→ CLIP → Regional Prompter (Mask-Based)
│ ├ width: 1024
│ ├ height: 1024
│ ├ soften_masks: true
│ ├ background: "city street"
│ ├ region1: "red sports car"
│ └ region2: "street vendor"
├→ MODEL → KSampler ← conditioning
└→ VAE → VAE Decode
Troubleshooting
Regions not showing:
- Check width/height match your latent exactly
- Try lower CFG (1.0-2.0) with Flux
- Verify boxes aren't outside image bounds
Validation errors:
- Ensure width/height are multiples of 64
- Check no regions overlap fullscreen
Blurry output:
- Lower CFG (Flux likes 1.0-3.5)
- Try strength 0.6-0.8 instead of 1.0
Advanced Nodes
Original nodes available for complex workflows:
- Multi Area Conditioning: Area-based, requires external CLIP encode
- Multi Area Conditioning Mask: Mask-based, requires external CLIP encode
- Multi Latent Composite: Visual latent compositing with feathering
Credits
Based on visual area conditioning by Davemane42.
Maintained by EnragedAntelope - github.com/EnragedAntelope/ComfyUI_RegionalConditioning
License
MIT License - use freely in personal and commercial projects.