Nodes/SimpleSyrup/Conditioning Batch Append
ComfyUI Node

Conditioning Batch Append

Growing a Per-Region Conditioning Batch, One Region at a Time

By Artificial-Sweetener·Created 3 months ago·Updated 12 days ago· 2
Conditioning Batch Append
  • batch
  • conditioning
  • batch

Regional prompting in ComfyUI is really just this: give each region its own conditioning, and keep the whole thing ordered so the right prompt lands on the right mask. SimpleSyrup carries those per-region conditionings around as a CONDITIONING_BATCH. If you're building a batch by hand, Conditioning Batch Append is the workhorse: it takes an existing batch and tacks one more conditioning entry onto the end, in SEGS order.

You'd think "append a value to a list" would be a solved problem, and it is - that's this node. It matters because ordering is the entire game in regional workflows. The batch you're extending was probably started by Conditioning Batch Start, and each Append you chain down the graph adds the next region's conditioning. Wire a batch through five Appends and you have a five-region batch, with each region's conditioning in exactly the chain order. Mis-order the chain and the face prompt lands on the hands region - the same trap ADetailer users hit with [SEP], just moved into graph form.

Inputs and output

  • batch (CONDITIONING_BATCH): the existing per-region batch to extend. Usually the output of Conditioning Batch Start or a previous Conditioning Batch Append.
  • conditioning (CONDITIONING): the next region's conditioning, added at the end of the batch.
  • output batch (CONDITIONING_BATCH): the extended batch, ready for another Append or for a batch-aware consumer like KSampler (Prompt by Region), Compose Regional Conditioning, or a detailer's per-region input.

That's it. No settings, no toggles.

When you'd use this instead of [SEP] text

Encode Prompt Batch is the fast path - write prompt one [SEP] prompt two and get a batch instantly. Hand-building with Start + Append only earns its keep when each region's conditioning can't come from a plain text line: per-region LoRA hooks, scheduled prompts, or conditioning that's the output of other nodes rather than a typed string. If you've got a graph where each region's conditioning is assembled separately, Append is the glue.

Install

SimpleSyrup is one pack. ComfyUI Manager → search SimpleSyrup → Install → restart. Or manually:

Set-Location ComfyUI\custom_nodes
git clone https://github.com/Artificial-Sweetener/SimpleSyrup.git
Set-Location SimpleSyrup
..\..\venv\Scripts\python.exe -m pip install -r requirements.txt

Restart ComfyUI afterward. Because the pack targets the v3 extension API, a stale ComfyUI build hides the whole category - update ComfyUI before you blame the nodes.

Common issues

  • Batch isn't growing - make sure you're chaining Appends (output of one into the batch input of the next), not splitting wires in parallel.
  • Regions mapped wrong - the Append chain order is the region order. Count the chain, then count the masks.
  • Nodes missing entirely - update ComfyUI, then check Manager's log for the requirements step.

It's a brick, not a feature, and that's fine - regional workflows fall apart without the brick.

CategorySimpleSyrup/Conditioning

Inputs (2)

NameTypeDefaultDescription
batchCONDITIONING_BATCHExisting per-region batch to extend in SEGS order.
conditioningCONDITIONINGConditioning to add as the next per-region batch entry.

Outputs (1)

NameTypeDescription
batchCONDITIONING_BATCHConditioning batch with the new entry added at the end.