Nodes/A8R8 ComfyUI Nodes/Attention Couple Regions
ComfyUI Node

Attention Couple Regions

Bundle more than one region together

By ramyma·Created 3 years ago·Updated 2 years ago· 74
Attention Couple Regions
  • region_1
  • region_2
  • region_3
  • region_4
  • region_5
  • region_6
  • region_7
  • region_8
  • region_9
  • region_10
  • region_11
  • regions
  • regions

Here's the gap this node fills: AttentionCouple's regions input only accepts a single AttentionCoupleRegion directly. Fine for two subjects (one base prompt, one region), useless the moment you want a three- or four-character group shot. AttentionCoupleRegions is the fan-in node - it takes a pile of individual regions and merges them into one bundle that AttentionCouple can read as a whole.

Judging by how little search traffic this page gets compared to its two siblings (42 impressions, zero clicks, versus over a hundred each for AttentionCouple and AttentionCoupleRegion), a lot of people land on the other two nodes, try to plug in a second or third region, and don't realize this bundler exists - they just hit the "only accepts one region" wall and assume that's a limitation of Attention Couple itself. It isn't. This is the node you're missing.

How it works

It's a pure pass-through/merge node - no attention math happens here, just packaging. Plug up to eleven AttentionCoupleRegion outputs into the numbered slots, and it hands back one combined regions object.

Inputs and outputs

Eleven optional slots, all the same type:

  • region_1 through region_11 (ATTENTION_COUPLE_REGION, all optional) - plug an AttentionCoupleRegion output into as many of these as you need. Leave the rest unconnected; there's no requirement to fill them in order or fill them all. Each slot just carries its own prompt+mask+weight - they aren't ranked or prioritized by slot number.
  • regions (ATTENTION_COUPLE_REGION, optional) - a twelfth input, same type as the output. This is for chaining: if eleven regions genuinely isn't enough, feed one AttentionCoupleRegions node's output into a second one's regions slot to keep extending the bundle.

Output: a single regions (ATTENTION_COUPLE_REGION) - wire it into AttentionCouple's regions input.

Installing it

Same pack as the other four nodes here - search "A8R8 ComfyUI Nodes" in ComfyUI Manager, or:

cd ComfyUI/custom_nodes
git clone https://github.com/ramyma/A8R8_ComfyUI_nodes

Restart. No extra dependencies, no models - it's a plain merge node.

Common issues

Confusing this with AttentionCoupleRegion. The names differ by exactly one letter, and side by side on a node-search dropdown they're easy to mix up. If you're trying to combine multiple prompts/masks into one image, you want the plural - this one.

A plugged-in region has no visible effect. Double-check it's actually landed in one of the eleven numbered slots (or chained through the regions input), not just floating on the canvas near the bundler. An unconnected node produces nothing regardless of how correctly it's configured.

Overlapping or touching regions still bleed. This node doesn't change the underlying attention-couple mechanics - it just lets more regions reach AttentionCouple at once. The same spatial-separation limitation covered on the AttentionCouple page applies to every region you bundle here: clean separation works well, overlap and physical contact between subjects still produce artifacts.

All eleven slots aren't a hard requirement to use. If you only need three regions, wire three and leave the other eight empty - there's no default/placeholder value that needs clearing, they're simply optional.

CategoryA8R8

Inputs (12)

NameTypeDefaultDescription
region_1optATTENTION_COUPLE_REGION
region_2optATTENTION_COUPLE_REGION
region_3optATTENTION_COUPLE_REGION
region_4optATTENTION_COUPLE_REGION
region_5optATTENTION_COUPLE_REGION
region_6optATTENTION_COUPLE_REGION
region_7optATTENTION_COUPLE_REGION
region_8optATTENTION_COUPLE_REGION
region_9optATTENTION_COUPLE_REGION
region_10optATTENTION_COUPLE_REGION
region_11optATTENTION_COUPLE_REGION
regionsoptATTENTION_COUPLE_REGION

Outputs (1)

NameTypeDescription
regionsATTENTION_COUPLE_REGION