← All docs

Docs

Prompt widgets & routers

Task-page documentation for INTERSTITIAL's Prompt Widget and Router canvas nodes, covering how to add each from the Add Element menu, connect inputs, set the widget's own prompt/model/seed, add reference images, and render, grounded in the widget components, hooks, and defaults.

Prompt widgets and routers are canvas nodes for building a generation flow: wire images into a node, and it renders or forwards them together. They let you run one prompt across many images at once.

When to use

  • You want to run the same prompt across several images in one click, instead of prompting each one from the prompt bar.
  • You want to fan out a single prompt or reference image to many render targets at once.
  • You are assembling a repeatable flow on the canvas rather than a one-off single-image render.

The Prompt Widget

A Prompt Widget (also called the Text Prompt Widget) is a standalone prompt tile. It holds its own prompt, seed, model, and render settings, and renders every image connected into it at once.

  1. Add it — open the Add Element menu (the + button), choose Prompt Widget, then click on the canvas to drop it where you want.
  2. Type the prompt — describe what to render across the connected images.
  3. Connect images — drag from the right side of the widget to each image you want it to render. The widget shows a plan of what it will render (for example, “Will render 3 images with your prompt”).
  4. Set the model — use the widget’s own model picker and the gear (render settings). These are independent of the prompt bar and are saved on the widget.
  5. Set the seed (optional) — lock the seed for repeatable results, type a number, or shuffle for a fresh one.
  6. Render — click the up-arrow button. Every connected image regenerates with your prompt.

The Render button stays disabled until the widget has both a prompt and at least one connected image.

Add reference images

  • Draw a connection line from another image into a render target, then activate the paperclip on that line. That image is sent as a reference for the render.
  • The widget’s reference indicator lists each reference and which target images it applies to, so you can see what will be sent before you render.

The Router

A Router is a transparent fan-out node: one input on the left, many outputs on the right. It carries no prompt or settings of its own — it just forwards whatever reaches it.

  1. Add it — from the Add Element menu, choose Router, then click to place it.
  2. Connect the input — wire a Prompt Widget or an image into the router’s left dock.
  3. Connect the outputs — wire the router’s right dock to every image you want to receive that input.

The router shows what it is doing: a lightning icon when it is forwarding a prompt (from a Prompt Widget input), a paperclip when it is forwarding a reference (from an image input), plus a count of its outputs. A Prompt Widget wired through a router to images can still render — the routed targets count as connections.

How it works

  • Connected images are resolved live. Nothing is baked in — the widget reads its connections at Render time, so re-wiring changes what the next Render targets.
  • Batches group by source. With a batch count above one, each connected image gets its variations placed near itself; render-stack members line up together. Batch counts follow your plan — see Plans & Credits.
  • Annotations ride along. If a target image has overlapping annotations or pinpoint comments, they are baked into that render, matching prompt-bar behavior.
  • Render is not undoable, results are. A Render is deliberately left out of undo history. The layers it produces are normal deletable layers, and deleting them is undoable.

Tips

  • The Prompt Widget is independent of the prompt bar. Its prompt, model, and settings live on the widget itself and persist with your project.
  • Lock the seed when you want the same look across a re-render; leave it unlocked to vary each result.
  • Reach for a router when one prompt or reference needs to hit many images — it keeps the wiring clean instead of drawing a line to every target by hand.