Extensions/Prompt Palette

ComfyUI Extension

Prompt Palette

Prompt editing and organization for ComfyUI: reusable wildcard libraries, a visual style sidebar, thumbnail autocomplete, offline Booru and Anima artist tags, controlled field comparisons, combinatorial batches, and model-aware weighting.

By z3rofeels·Created 4 months ago·Updated 5 days ago· 17

z3rofeels/comfyui-promptpalette

Nodes3

On cloudLocal install

CategoryPromptPalette

Stars17

Updated5 days ago

Nodes (3)

Prompt Palette (Combinatorial)

Stop clicking Run a hundred times — generate every prompt combo at once

PromptPalette

Prompt Palette

The prompt box that color-codes wildcards and encodes itself — Prompt Palette

PromptPalette

Prompt Palette (Weight Controller)

1.35) gets silently thrown away — translate weights to your backend

PromptPalette

Readme

<img width="1856" height="576" alt="Prompt Palette banner" src="https://github.com/user-attachments/assets/475b8530-cd4d-4a5b-a517-3c72b54111f7" /> Your new best friend when it comes to prompting in ComfyUI Prompt editing, wildcard libraries, batch generation, and model-aware weighting for ComfyUI. <img alt="GitHub stars" src="https://img.shields.io/github/stars/z3rofeels/comfyui-promptpalette?style=for-the-badge&color=6ee7b7&labelColor=11131a"> <img alt="Last commit" src="https://img.shields.io/github/last-commit/z3rofeels/comfyui-promptpalette?style=for-the-badge&color=60a5fa&labelColor=11131a"> <img alt="ComfyUI Nodes 1 and 2" src="https://img.shields.io/badge/ComfyUI-Nodes%201.x%20%2B%202.x-a78bfa?style=for-the-badge&labelColor=11131a">

[!TIP] Start with Prompt Palette. The Combinatorial and Weight Controller nodes are specialized companions—not requirements. Add them only when your workflow needs batch expansion or dedicated prompt-weight routing.

<a href="#recent-updates”>Recent updates</a> · <a href="#installation">Installation</a> · <a href="#choose-your-node">Choose a node</a> · <a href="#prompt-palette">Prompt Palette</a> · <a href="#combinatorial">Combinatorial</a> · <a href="#weight-controller">Weight Controller</a> · <a href="#booru-autocomplete">Autocomplete</a> · <a href="#wildcard-syntax">Syntax</a> · <a href="#troubleshooting">Troubleshooting</a>

Recent updates — 2.0.7

Library thumbnails, everywhere you browse

Right-click a wildcard in the node’s slide-out Library, in list or gallery view, to Set, Change, or Remove Thumbnail. The same actions are available on main-sidebar library entries and library autocomplete suggestions.
The shared library editor keeps its Add/Replace/Remove controls. Replacements refresh across open editors, galleries, autocomplete, and their image previews, including other browser tabs.
PNG/JPEG images up to 8 MB stay beside their TXT entries. New-entry images attach when you save; failed uploads keep staged images available to retry.

A clearer prompting sidebar

Artists brings Anima, Booru artist tags, and classic references into one workspace with a remembered catalog picker. Booru tags stays separate for subjects and details. Favorites, your previews, and imported words have direct shortcuts.
Syntax → Choose your prompting language offers editable starters for plain language (Krea 2 / Qwen-Image), tag-based prompting, MOSS captions/layout guidance, and image editing instructions.
The sidebar’s gear has its own controls for tabs, collections, introductions, and model guidance. Hide what you don’t use or choose Show all sections to restore it. Main editor settings stay separate.
Tighter sidebar spacing and narrow-width labels; collection switching handles loading and retries cleanly. Edited prompt starters stay intact when you switch guide categories.

Editing and visual autocomplete

Attached thumbnails appear in autocomplete, with a small hover preview where there is room. Entries without images stay as text. Use Images in the menu or Settings → Editor & suggestions → Autocomplete images to switch them off; saved choices are retained.
Ctrl/Cmd+Enter passes through to ComfyUI to start a run while editing, including with autocomplete open.
Right-click opens Prompt Palette actions; right-click a __library entry__ to choose random, next, previous or cycle modes. Alt/Option+right-click opens browser/Desktop spelling and editing suggestions. Spellcheck is enabled in Fields and library editing too.

MOSS-Image prompting

New MOSS caption, ordered tags, and 1024×1024 layout JSON starters in Layouts. Keep exact lettering separate and retain normal field variation tools.
Complete valid JSON objects stay literal through prompt resolution and batches, preserving layout braces and quoted text. Choices and wildcards outside JSON work normally.
Local Base INT8, toxicdog Turbo AIO, and regular-SFT workflow examples. Use ComfyUI 0.42.1+ for native MOSS support and its template crash fixes.

Compare one prompt change at a time

In a Fields workspace, open Variation Lab → Explore → One field at a time. Capture a baseline, then test each selected field while every other resolved phrase stays fixed—including Follow fields and negative text.
Review exactly what changed, keep useful trials, and send the resolved batch to Combinatorial with Fixed seed mode. Original choices stay available. Previewing never queues images.
Prepared batches now keep each positive prompt with its matching negative. New Negative prompt list and Negative conditioning list outputs support negative-prompt comparisons too.

More visual sidebar browsing

193 bundled images now include 120 SFW Anima portrait references alongside the existing 73 public-domain/CC0 references. 64 Booru concept tags link to these reference images. Each image keeps its source and rights information; Anima previews are model interpretations, not original artist works.
Choose Studio, Showcase, or Minimal, control visible card text and guidance, and fit the full image or fill its frame. Existing gallery/list layouts and 10–150% item sizing remain available.
Explore groups styles, artists, Booru tags, favorites, personal previews, and imported words beside the canvas.

Recent features — 2.0.6

Prompt Palette in the main sidebar

Open Library, Styles, Syntax, and Tools beside the ComfyUI canvas.
Choose Insert into to send entries to Prompt Palette, Combinatorial, an active workspace field, or another compatible text field.
Click an entry to insert it; use its pencil to edit. Quick view previews its contents first.
Switch between gallery cards and compact lists.

Offline style gallery & Anima artists

Browse styles, classic artists, Booru tags, and a separate Anima artist collection with 59k+ names. Search and filter by available labels such as medium, color, mood, or visual treatment.
Explore 73 real public-domain or CC0 reference images, with source and rights information. Attach your own previews and save favorites across collections.
Choose literal Booru/Pony/Illustrious tags, Anima @artist, or natural-language descriptions. Will insert shows the text before you add it.
Type @ in a prompt to search the local Anima artist snapshot. Ordinary Booru tags and custom words stay plain text; library entries keep their __wildcard__ syntax.

Fields that vary during generation

Vary cycles through supplied choices each generation, even with a fixed seed. Choose Cycle, Shuffle, By seed, or Use written syntax in field settings.
Lock captures a resolved value and keeps it across seed changes and reloads. Follow changes a choice only when a selected source field changes.
Choose purpose-built starter layouts for portraits, character sheets, scenes, products, photos, anime, Anima, or negative prompts. Start with example content or empty fields, using natural-language, Booru, or Anima starters.
Keep named snapshots and variants, compare field changes, and reuse saved workspace versions without rebuilding a prompt.

Library editing that keeps your place

Editing an existing entry loads its saved prompt options and preserves its name, including capitals, spaces, and Unicode.
Use autocomplete, Suggest, Syntax, Find, and Expand for quick fixes or longer edits. Clean up groups sorting, duplicate removal, and whitespace tools.
Back to library keeps your draft; Resume brings it back. Saved/unsaved badges, option counts, and cursor indicators make the current state clear.
Changing an entry path offers Save copy. Existing entries and unsaved edits are protected from accidental replacement.

More flexible controls & syntax help

Scale toolbar buttons, rearrange them, and choose always visible, auto-hide, collapsed, or hidden modes.
Updated settings and sidebar controls follow the same dark, light, and custom themes.
The sidebar's visual syntax guide explains choices, wildcards, reusable variables, and conditional text. switch / case / default adds a readable way to choose between several named cases.
Enable the optional Positive Antonyms tool to replace supported descriptors in the resolved positive prompt while preserving authored text and the negative prompt.

All browsing and autocomplete use local data. No account, API key, or runtime downloads are required.

Recent features — 2.0.5

Booru autocomplete & custom words

Local tag suggestions with category colors, aliases, and custom shortcuts.
Choose Off, Auto, or On demand (Ctrl+Space); import and export your custom words.
Narrow results with artist:, character:, series:, general:, or meta:. See Autocomplete for examples.

Adjustable prompt workspace & selective variation

Build positive and negative prompts from editable, reorderable recipe fields.
Use Lock / Vary / Follow to control which fields change during variation.
In Variation Lab, compare unique results, hide duplicates, and Keep favorites to copy or send to Combinatorial.
Combinatorial also includes the structured workspace, Variation Lab, Prompt Doctor, and recipe tools.

Customizable toolbar

Choose Small, Medium, or Large buttons and rearrange their order.
Use Always visible, Click to open, or Auto-hide; Keep open pins the toolbar for that node.
Show only the shortcuts you need, including the optional image-import button. Controls follow your dark, light, or custom theme.

Import prompts from images

Drop a PNG, JPEG, or WebP onto Editor or Combinatorial, or choose Import prompt from image.
Preview positive and negative text before importing. Choose the authored template or resolved prompt when Palette metadata is available.
Supports Palette metadata, ComfyUI API prompt graphs, and A1111 generation metadata. Images need embedded metadata to recover a prompt.

Choices, rules & prompt inspector

Open Choices & rules from the right-click or syntax menu to build fixed choices, seeded choices, and variable-based conditions.
Preview a rule before inserting it, then reopen it to edit.
Prompt inspector shows explicit weights, embedding availability, and a CLIP-L reference token layout.
Syntax menus group actions with theme-colored labels and keyboard navigation.

Editing & library improvements

Improved text selection, undo, list saving, and saved workspace restoration.
Library edits refresh across open nodes and browser tabs connected to the same ComfyUI server.
Autocomplete formatting choices persist; saved node sizes and hover previews behave more consistently.

Optional tools can be enabled individually in Settings.

| Node | Best for | What it returns | |---|---|---| | Prompt Palette | Everyday prompt writing, wildcard browsing, editing, organization, previewing, and optional encoding | Resolved prompt text, optional positive/negative conditioning, model/CLIP passthrough, seed and wildcard metadata | | Prompt Palette (Combinatorial) | Producing many deliberate prompt variations from one template | Lists of prompts, seeds, wildcard metadata, and optional per-prompt conditioning/model/CLIP outputs | | Prompt Palette (Weight Controller) | Applying and translating explicit (phrase:weight) instructions for different text backends | Backend-ready text, raw weight dictionary, compatibility text, optional conditioning, model/CLIP passthrough |

All three nodes appear under the PromptPalette category and share autocomplete and theme settings.

Standard ComfyUI

Use Python 3.10+ and a current ComfyUI build with the V3 custom-node API. The optional MOSS examples require ComfyUI 0.42.1+ and the model files listed in the MOSS guide. Prompt Palette contains node code and bundled reference data, not model weights.

Search for Prompt Palette by z3rofeels in ComfyUI’s extension manager (Registry ID: zf-prompt-palette).

or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/z3rofeels/comfyui-promptpalette.git
python -m pip install -r comfyui-promptpalette/requirements.txt

Use the Python environment that runs ComfyUI to install requirements. Restart ComfyUI, then search the node menu for Prompt Palette.

<details> <summary>Windows portable command</summary>

Run this from your ComfyUI_windows_portable folder:

cd ComfyUI\custom_nodes
git clone https://github.com/z3rofeels/comfyui-promptpalette.git
..\..\python_embeded\python.exe -m pip install -r comfyui-promptpalette\requirements.txt

Restart the portable launcher after installation.

</details> <details> <summary>Updating</summary>

cd ComfyUI/custom_nodes/comfyui-promptpalette
git pull
python -m pip install -r requirements.txt

Restart ComfyUI and hard-refresh the browser after frontend updates.

[!IMPORTANT] Before a manual update, back up your custom files and configuration. For a v1 → v2 update, use a clean extension folder, then restore your custom files. Keep only one active Prompt Palette installation.

</details>

Wildcard library location

By default, Prompt Palette creates and scans:

ComfyUI/wildcards/

It supports nested .txt, .yaml, and .yml libraries. Choose a different wildcard folder in Settings on the computer running ComfyUI. Advanced setups can use wildcards_config.json or a wildcards: entry in ComfyUI's extra_model_paths.yaml.

Example:

ComfyUI/wildcards/
├── characters/
│   └── monsters.txt        → __characters/monsters__
├── lighting/
│   └── cinematic.txt    → __lighting/cinematic__
└── styles.yaml          → nested YAML keys become slash paths

Prompt Palette replaces the plain prompt box with a full wildcard-aware editor while remaining useful as a simple text node. Leave every optional socket disabled and it behaves like a normal resolving prompt box; connect CLIP and MODEL only when you want live encoding and LoRA handling.

The 30-second tour

Type normally. __wildcards__ are color-coded by their folder.
Open the Prompt Library to search My Library or the optional Starter Packs, preview entries, and insert what you need. Starter Packs are library content only; they are not added to autocomplete suggestions.
Open Edit to create or change .txt wildcards without leaving ComfyUI.
Use Resolved Preview to inspect the actual returned prompt; choose Manual, After pause, or Live updates in Settings.
Open Settings for Theme Studio, workspace controls, text sizing, wildcard paths, optional tools, and socket visibility.

Wildcard-first editing

Folder colors and legend make long prompts readable at a glance.
Missing wildcard detection marks broken references and lets you jump to the next one.
Autocomplete opens when you type __.
Booru tag autocomplete suggests tags and custom words as you type. See Autocomplete for settings and category filters.
Hover preview shows a wildcard file's contents without inserting it.
Double-click a token to open that wildcard directly in the editor.
Right-click a token to open the Syntax Injector and rewrite that exact occurrence.
Undo and redo cover typing, inserts, autocomplete, syntax changes, and clearing.

Prompt workspace & toolbar

Enable the Adjustable Recipe Workspace in Settings → Power tools to organize a prompt into fields such as subject, outfit, setting, and lighting. Rename or reorder fields, choose separators, and check the compiled preview. Workspaces support positive and negative prompts.

Give a field alternatives with Set choices—one option per line—or Insert wildcard, then choose how it behaves. A field containing only plain text has one value to use.

| Field mode | During generation | |---|---| | Vary | Cycles through your choices each generation, including with a fixed seed. Field settings also offer Shuffle, By seed, or written syntax. | | Lock | Captures the current resolved choice and keeps that text across seed changes and reloads. Your original choices remain available. | | Follow | Holds its choice until a selected source field changes, then chooses again. Pick the source in field settings. | | Default | Uses the field's authored prompt syntax normally. |

For example, let Lighting follow Pose: when the resolved pose changes, lighting can change too. Follow responds to changes; it does not match the meanings or line numbers of two lists.

Open Layouts for a starter suited to your task. Choose natural language for Krea 2/Qwen-style prompts, tags for Illustrious/Booru, or Anima scene prose and character tags. Include starter choices adds example content; turn it off for empty fields. Save your own field presets with structure only or with default values. Use Snapshots & variants to save checkpoints, keep alternate versions, and compare field differences.

In Variation Lab, compare previews, hide duplicates, and check Keep on results you want to reuse. Apply a preview to the targeted fields while keeping their choices available, or send kept full versions to Combinatorial for batch generation.

Choose One field at a time to find out what one lighting, camera, style, or negative-prompt change contributes. The first card is the resolved Baseline. Each following trial replaces one field and holds all other resolved text fixed; Follow is held during these comparisons. Samples per field sets the search budget, with duplicates skipped. It samples alternatives rather than exhaustively expanding them; large workspaces share a budget of at most 256 total trials. Use field value applies that field only; the rest of your workspace keeps its authored text and generation behavior.

Send to Combinatorial creates an exact batch in preview order and starts its seed mode at Fixed. Connect Seed list to your sampler's seed input and keep its other settings unchanged to compare with the same noise seed. When negatives differ, connect Negative conditioning list (with CLIP connected), or Negative prompt list to your text encoder. Those outputs appear automatically for a batch with varying negatives. Single-value negative outputs return the first trial. Keep selects the trials to send; without a shortlist, all visible trials are sent. The sampler and model still determine the images.

Customize the Editor toolbar under Settings → Workspace → Toolbar layout; Combinatorial has the same controls under Settings → Generation. Use the 60–180% size slider or a size preset, choose a visibility mode, then use Arrange buttons to drag buttons or move them with arrows. Reset order restores the default arrangement. In retractable modes, Tools opens the toolbar and Keep open holds it open. Hidden keeps shortcuts out of the way while Settings stays accessible.

Recover a prompt from an image

Choose Import prompt from image or drop one PNG, JPEG, or WebP onto the editor. Review the recovered text, choose Authored template or Resolved prompt when available, and decide whether to import the negative prompt. The import can be undone.

If an image has no negative-prompt metadata, your existing negative stays intact. Prefixes, suffixes, seeds, and connected inputs still apply, so check the final preview before queueing. Images without embedded prompt metadata cannot be used for recovery. Maximum image size: 32 MB.

Prompt Library, recipes, and stash

<table> <tr> <td width="33%" valign="top">Prompt Library Search My Library, browse folders, switch between list/grid views, use thumbnails, favorites and Recent, and keep RECIPES alongside normal local entries.</td> <td width="33%" valign="top">Palette Recipes Save reusable prompt building blocks so a familiar combination is never more than a click away.</td> <td width="33%" valign="top">Prompt Stash Temporarily park prompts inside the node instead of opening extra text nodes or external notes.</td> </tr> </table> <table> <tr> <td align="center"><img width="430" alt="Wildcard gallery mode" src="https://github.com/user-attachments/assets/c71b9c45-c315-47d2-973f-d91176d94459"></td> <td align="center"><img width="500" alt="Palette Recipes" src="https://github.com/user-attachments/assets/f6792bd7-b9d2-4e9a-b2ab-01e15f31a0a5"></td> <td align="center"><img width="500" alt="Prompt Stash" src="https://github.com/user-attachments/assets/42de2118-e9a9-40c1-8eae-b965d679398c"></td> </tr> </table>

Main sidebar & style explorer

Open Prompt Palette in ComfyUI's main sidebar. Choose Insert into before adding text; browsing and library editing work without a target node.

| Tab | What you can do | |---|---| | Library | Search folders, pinned entries, and recents; preview entries, insert wildcards, or edit with the pencil. | | Styles | Explore styles, classic artists, Anima artists, Booru tags, custom words, favorites, and your previews. | | Syntax | Browse explained examples, adjust a template, preview it, and insert it at your target cursor. | | Tools | Open prompting tools supported by the selected node. |

In Styles, use the available filters to narrow a collection. Clear filters to find artists without matching labels. Check Prompt language and Will insert: Anima uses @artist, Booru/Pony/Illustrious use literal tags, and natural-language mode uses readable descriptions. Quality prefixes are optional and are not added automatically.

Cards can use your own local preview images. Compare up to four styles with a shared subject, copy their prompts, and attach your own generated samples. Bundled artwork is a visual reference, not a promise of a checkpoint's output. Image credits and sources are included.

Edit a library entry

Click its pencil to open the saved text. Each non-comment line is one option and can contain a short tag or a complete prompt.

Suggest or Ctrl+Space opens available completions; Syntax works at the cursor or around selected text.
Find searches within the entry; Expand gives the text more room. Clean up offers sorting, duplicate removal, and whitespace cleanup.
Save updates the entry. Changing the path offers Save copy and leaves the original in place.
Back to library retains your draft; Resume reopens it. Revert restores the saved text.
Use Copy for the wildcard reference or Use to insert the saved entry into your selected target. Save changes before using the edited entry.

The sidebar and node edit drawers share these prompt tools. Existing capitalization, spaces, and Unicode in entry names are preserved. YAML/JSON entries can be viewed here; edit their source file to change them.

Starter Packs

Starter Packs are optional built-in examples kept separate from My Library. They are there to show useful syntax and model-oriented prompt structures without mixing bundled content into your own wildcard folders.

Included packs cover Prompt Palette Syntax, Universal, KREA 2, MiniMax H3, Qwen Image, Z-Image Turbo, LTX-2.3, Anima, Illustrious, Pony, and SDXL. Disable Starter Packs in Settings if you only want your own library.

Optional Power Tools

Each Power Tool is independent and can stay off unless you want it.

Prompt Doctor — local prompt/library syntax checks for missing or empty wildcards, unclosed expressions, undefined variables, malformed parameter calls, duplicate LoRA tags, and similar issues.
<img width="986" height="566" alt="PPalDoc" src="https://github.com/user-attachments/assets/f25b99f0-bd36-4de4-b0ed-ed7b9eccff00" />
Variation Lab — preview multiple deterministic wildcard resolutions before queueing, then copy or reuse a result with its seed.
<img width="1494" height="989" alt="PPalVari" src="https://github.com/user-attachments/assets/95b67457-45b8-47b3-a300-ee7b60fbde14" />
Resolved Diff — highlights what changed between the editable source and the resolved prompt.
Library Manager — larger-library management and health tools, including multi-select and supported reversible operations.
Recipe Builder 2 — richer RECIPES creation with ordering, wildcard mode, separator, prefix, suffix, and source preview.

Prompt Palette can also expose its actions through ComfyUI's command palette when that integration is enabled.

Optional encoder and workflow sockets

Nothing is required. Enable only the sockets your graph needs.

Optional inputs

clip — encodes the resolved positive and negative text.
model — enables <lora:name:weight> loading when CLIP is also connected.
prompt_prefix / prompt_suffix — add reusable text before or after the main prompt.
enhancer_override — replaces the resolved positive prompt when a connected enhancer returns text.
external_seed — takes seed control from another node.
negative_text, negative_prefix, negative_suffix — build and resolve the negative side in the same node.

Optional outputs

Patched model and clip
Positive and negative conditioning
Resolved positive and negative prompt strings
Effective seed
Wildcards used and wildcard count
Original unresolved text
Enhancer-used flag
Real CLIP-L token count
Prompt Palette metadata JSON

Socket visibility and socket-label visibility are separate controls, so a socket can stay connected while its displayed label is hidden when you want a cleaner graph.

[!NOTE] LoRA tags are applied only when both MODEL and CLIP are connected. With only CLIP connected, the tags are removed before encoding instead of being encoded as text. Tags are scanned after wildcard resolution, so a wildcard entry may contain <lora:name:weight>.

Themes and accessibility

72 built-in palettes across 12 collections: Soda Shop, Planetarium, Ocean, Garden, Sweet Shop, Pixel Arcade, Trailhead, Night, Daylight, Creative, Professional, and Materials
Full-width Theme Studio with larger previews and collection browsing
Suite-wide saved appearance for Prompt Palette, Combinatorial, and Weight Controller
Independent day and night theme pairing
Editable custom themes with import/export
Per-category wildcard colors
Hue and saturation controls
Custom prompt and interface fonts
Separate prompt/interface text sizes
Dedicated prompt text color
Corner-roundness and other presentation controls
Workspace presets for a minimal or expanded interface
Density, toolbar, preview, motion, contrast, and interface-size controls

Prompt Palette themes cover its own nodes, sidebar, and menus. They do not recolor the ComfyUI canvas or unrelated nodes and interface panels.

The Combinatorial node turns one wildcard-aware template into a list of resolved prompts in a single node execution. It shares Prompt Palette's editor, browser, theming, and syntax tools, but its main outputs are list-based so downstream nodes can fan out over the generated set.

Choose a generation mode

| Mode | What it does | Use it when | |---|---|---| | Random | Resolves the template count times with independently derived seeds. Sampling is with replacement, so repeats are possible. | You want a controlled number of quick variations without expanding the complete space. | | Combinatorial | Expands every unmarked wildcard and choice group into the full Cartesian product, stopping at max_prompts. | You want every subject × outfit × location pairing, a test matrix, or a complete prompt sweep. |

Example:

a __subject__ wearing __outfit__ in __location__

With 3 subjects, 4 outfits, and 5 locations, Combinatorial mode produces 3 × 4 × 5 = 60 prompts.

Controls

count — number of prompts in Random mode; ignored in Combinatorial mode.
seed — base seed used to make the run reproducible.
seed_mode
- Sequential — seed, seed + 1, seed + 2, …
- Fixed — reuse the same seed for every generated prompt.
- Random — derive a reproducible sequence of random seeds from the base seed.
max_prompts — Combinatorial-only safety cap. 0 uses the built-in limit of 5,000.
Estimated output — updates before the run and warns when expansion will hit the cap.

What expands—and what does not

In Combinatorial mode, ordinary unmarked groups expand:

__subject__
{red|blue|green}

A group carrying an explicit sampler marker such as +, -, *, ~, @, or % opts out of full expansion and makes one pick per generated prompt. This lets one part of a template stay random or sequential while the rest expands exhaustively.

Outputs and fan-out

The node has two kinds of outputs. Open the I/O button on the node to show or hide any of them.

List outputs hold one entry per generated prompt: Model list, CLIP list, Conditioning list, Prompt list, Seed list, Wildcards used, Prompt metadata (JSON) list, Negative prompt list, and Negative conditioning list. Positive and negative lists use the same order. Ordinary batches repeat their shared negative; prepared batches can carry different negatives.

Single-value outputs are not lists, so whatever they feed runs once per queue, not once per prompt:

| Output | Value | |---|---| | Model (passthrough) / CLIP (passthrough) | The connected Model / CLIP, unchanged | | Conditioning (first) | Conditioning for the first generated prompt (needs CLIP) | | Negative conditioning | The first negative prompt encoded with the unpatched CLIP (needs CLIP) | | Prompt (first) / Seed used (first) | The first generated prompt and its seed | | Negative prompt | The first resolved negative text; ordinary batches share it across all prompts | | Wildcards used (JSON) / Wildcards used (count) | Wildcard files picked during the batch, as one JSON value / a count | | Raw text (unresolved) | The template before resolution | | Used enhancer override | True when the enhancer override replaced the prompts | | CLIP token count (max) | Highest CLIP-L token count in the batch, or -1 | | Batch metadata (JSON) / Prompt count | One record for the whole batch / how many prompts were generated |

The node also accepts the same optional input sockets as Prompt Palette: Prompt prefix, Prompt suffix, LLM / enhancer override, External seed, Negative prompt (text), Negative prefix, and Negative suffix. Prefix and suffix are resolved per generated prompt (they are not expanded combinatorially). An enhancer override replaces every prompt and keeps the batch length and seeds.

[!WARNING] In ComfyUI, a list output can cause connected downstream nodes to execute once per item. An estimated output of 500 prompts can therefore become 500 sampler runs. Use the live estimate and max_prompts deliberately.

When both MODEL and CLIP are connected, each generated prompt can load and apply its own LoRA tags before encoding. That matters when different wildcard combinations select different LoRAs.

The Weight Controller is a standalone text-routing companion. Feed it Prompt Palette's resolved prompt, negative_prompt, raw_text, or any other STRING. It reads explicit (phrase:weight) annotations and returns the format expected by the selected backend.

Input syntax

a portrait of a (red fox:1.35), dusk lighting, (blurry:-0.8)

Weight 1.0 is neutral.
Values above 1.0 emphasize a phrase.
Values below 1.0 reduce it.
Negative values request suppression where the downstream backend supports negative weighting.
Nested weighted parentheses are not supported; keep each weighted phrase in its own top-level group.
Bare (word) or [word] shorthand is not interpreted. Use the explicit :weight form.

Weighting modes

| Mode shown in the node | text output | Typical route | |---|---|---| | SDXL / CLIP (Standard) | Keeps (phrase:weight) annotations intact | Standard ComfyUI CLIP tokenization; connect CLIP for direct conditioning | | Krea 2 / ZIT (Qwen) | Returns clean de-bracketed prose | Send clean text to the Qwen-family encoder; use negpip_compatible for a downstream attention/negative-weight patcher that parses explicit weights | | LTX 2.3 / T5 (LLM) | Returns clean de-bracketed prose | LLM/T5/Gemma-style text encoders that should receive natural language without literal weight brackets |

Outputs

text — formatted for the selected weighting mode.
weight_dict — raw {phrase: weight} values exactly as authored, excluding neutral 1.0 segments.
negpip_compatible — always emits explicit weighted text for downstream nodes that parse (phrase:weight).
conditioning — populated when CLIP is connected.
model / clip — untouched passthrough sockets for cleaner graphs.
clip_token_count — token count for the node's final text output.

Advanced controls

Advanced controls are intentionally off by default.

Soft Safety Clamp compresses extreme weights toward 1.0 while leaving values near neutral mostly unchanged.
Zero Inversion Null affects clean-prose modes only. Because plain prose cannot carry a negative multiplier, negatively weighted phrases are removed instead of silently becoming normal unweighted text.

[!IMPORTANT] weight_dict always preserves the raw number you entered. Clamping and negative routing affect generated text/conditioning outputs—not the dictionary.

Recommended wiring

Connect Prompt Palette's prompt output to Weight Controller's text input, then choose the output your workflow needs:

| Output | Connect to | |---|---| | text | Your model's text encoder | | negpip_compatible | A compatible attention or negative-weight patcher | | conditioning | The sampler's conditioning input, when CLIP is connected |

Add a second Weight Controller after Prompt Palette's negative_prompt output when the positive and negative sides need independent handling.

The Syntax Injector inserts most of this for you from the wildcard browser or a token's right-click menu.

Everyday syntax

| Syntax | Meaning | |---|---| | __name__ | Seeded random line from a wildcard file | | __*name__ or __~name__ | Unseeded random line; may change every run | | __+name__ | Sequential forward | | __-name__ | Sequential backward | | __@name__ | Cyclical/sequential-forward alias used by Dynamic Prompts syntax | | __%name__ | Joint combinatorial step across every % group in the same normal Prompt Palette resolve call | | {a\|b\|c} | Seeded inline choice | | {*a\|b\|c} or {~a\|b\|c} | Unseeded inline choice | | {+a\|b\|c} / {-a\|b\|c} | Sequential inline choice | | {@a\|b\|c} | Cyclical inline choice | | {%a\|b\|c} | Joint combinatorial inline step | | {2::common\|1::rare} | Weighted random choice | | {2$$, $$a\|b\|c} | Pick exactly two items and join with , | | {1-3$$, $$a\|b\|c} | Pick between one and three items | | <lora:name:0.8> | Load/apply a LoRA when MODEL and CLIP are connected |

<details> <summary>Advanced templates, globs, and variables</summary>

| Syntax | Meaning | |---|---| | __colours*__ | Pool entries from wildcard names matching a glob pattern | | __artists/**__ | Recursive wildcard glob below a folder | | __template(subject=fox)__ | Use a wildcard file as a parameterized multi-line template | | ${name=value} | Assign a variable that is re-evaluated when read | | ${name=!value} | Assign and resolve a variable once immediately | | ${name} | Read a variable | | ${name:default} | Read a variable with fallback text | | {3#__name__} | Expand the wildcard token three times before multi-select processing | | [if expression] ... [elif expression] ... [else] ... [/if] | Conditionally include prompt text using existing Prompt Palette variables | | [switch name][case "value"]text[default]fallback[/switch] | Use the first matching case, or the default when none match |

Nesting is resolved innermost-first. Lines beginning with # are treated as comments and omitted during resolution.

Conditional prompt blocks

Conditional blocks include different text based on your prompt variables. Conditions operate on Prompt Palette variables and are evaluated again for each Combinatorial branch.

${style=anime}
A character portrait. [if style == "anime"]cel shading, vivid colors[elif style == "realistic"]natural skin texture, realistic lighting[else]clean studio lighting[/if]

Supported operators are ==, !=, >, >=, <, <=, in, and, or, and not. in accepts a compact pipe-separated set such as style in anime|illustration|realistic. Conditionals can be nested.

Use switch for several alternatives based on one variable:

${mood=calm}
A landscape, [switch mood][case "calm"]soft morning light[case "dramatic"]storm clouds and hard shadows[default]balanced daylight[/switch]

The first matching case is used; otherwise the default text is included. For combined conditions, use expressions such as [if style == "anime" and mood != "dark"]vivid cel shading[/if].

The sidebar's Syntax tab explains these patterns and lets you edit a template before inserting it. You can also open Choices & rules from a prompt's right-click menu.

</details>

`%` inside Prompt Palette vs. the Combinatorial node

% syntax in the regular Prompt Palette node advances one joint combination per execution.
The dedicated Combinatorial node returns the entire expansion set in one execution and does not require % markers.

Booru autocomplete & custom words

Type a tag after a space or comma to search the bundled offline Danbooru tags and your custom words. Choosing a result inserts plain prompt text. Typing __ still opens wildcard suggestions.

Anima artist search

Type @ followed by a name to search the separate bundled Anima artist snapshot. Selecting an artist inserts @artist name. Use the sidebar's Styles → Anima collection to discover names without already knowing what to type.

The Anima artist formatting setting can also format recognized artist suggestions for Anima. Other Booru tags and custom words remain literal prompt text, and only library entries are inserted as __wildcards__. Artist results depend on the checkpoint; the local name collection does not certify model support.

@artist is different from __@name__: the former is Anima artist text; the latter is the existing sequential wildcard alias.

Autocomplete settings

Open Settings → Autocomplete:

| Setting | What it does | |---|---| | Off | Turns off bare-word tag suggestions; wildcard autocomplete remains available. | | Auto | Opens suggestions after the minimum number of characters. | | On demand | Opens suggestions when you press Ctrl+Space. | | Minimum characters | Choose 1–12; default is 2. | | Booru database / Custom Words | Choose which sources to search. | | Color tags in prompt | Colors recognized tags in the editor by category. |

Use arrow keys to browse, Enter or Tab to insert, and Esc to close. Optional menu controls convert underscores → spaces or append comma; your choices are saved. Booru tags and custom words are inserted as stored, subject to your selected formatting options; they are not wrapped in __.

Filter by category

| Search | Category | |---|---| | artist:monet | Artists | | character:saber | Characters | | series:zelda | Series / copyright | | general:portrait | General tags | | meta:highres | Metadata tags |

Aliases art:, char:, copyright:, copy:, and gen: also work. Selecting a result replaces the category prefix and search term with the tag. Filters also apply to categorized custom words, favorites, and recents; uncategorized words remain available in ordinary searches.

Readable suggestions

Category colors follow your theme and remain separate from wildcard folder colors.
Recognized tags can keep their colors inside the prompt, including pasted and saved tags.
Tags already in the prompt are dimmed and marked with ✓.
Search matches tags and aliases, including text inside a name; multiple search terms can appear in any order.
Exact custom-word matches take priority over database tags.

Add, import & export custom words

Click + Custom word in the autocomplete menu to save a word or phrase. Add optional shortcuts and a category, then press Save. Use Manage to search, remove, import, or export entries. CSV and text imports can add to or replace your list; replacement keeps a backup. Large imports of 100 MB or more ask for confirmation.

Custom words are saved in prompt_palette/autocomplete.txt inside ComfyUI's user directory and survive extension updates. To edit them by hand, use one entry per line:

tag,category,count,aliases
saber_(fate),character,120000,"saber,/sab"
hatsune_miku,character
fate/grand_order,series,90000
long phrase to insert,lp

Only the tag is required. Categories accept names or Danbooru IDs: 0 general, 1 artist, 3 copyright, 4 character, and 5 meta. Optional counts rank entries; aliases provide search shortcuts. A two-column phrase,shortcut row saves a phrase with a shortcut.

To create a wildcard list from a prompt, select comma- or newline-separated tags and choose Save as list in the autocomplete menu. This works in Editor and Combinatorial.

Keyboard and mouse shortcuts

| Shortcut | Action | |---|---| | Ctrl/Cmd + Z | Undo | | Ctrl/Cmd + Shift + Z or Ctrl/Cmd + Y | Redo | | Ctrl+Space in On-demand mode | Open Booru autocomplete for the current bare word | | Ctrl/Cmd + S in the Edit drawer | Save the current wildcard file | | Ctrl/Cmd + F in a library editor | Find text within the current entry | | Ctrl+Space in a library editor | Open available suggestions at the cursor | | Esc | Close the active drawer, menu, or popup | | Ctrl/Cmd + Enter | Pass the run shortcut through to ComfyUI | | Right-click prompt text | Open Prompt Palette actions | | Alt/Option + right-click prompt text | Open native spelling and editing tools | | Right-click a wildcard token | Open the Syntax Injector for that occurrence | | Double-click a wildcard token | Open that wildcard in the Edit drawer |

Troubleshooting

<details> <summary>The node loads, but its custom UI does not appear</summary>

Update ComfyUI and its frontend.
Restart ComfyUI completely.
Hard-refresh the browser (Ctrl/Cmd + Shift + R).
Confirm the repository folder is named comfyui-promptpalette and contains the web/ directory.
Open the browser console and look for messages beginning with [PromptPalette] or Prompt Palette:.
When reporting the issue, include whether you use Desktop or portable, Nodes 1.x or 2.x, the frontend version, and the first relevant console error.

</details> <details> <summary>My wildcard stays unresolved</summary>

Confirm the file exists below the active wildcard library path.
Use slash paths without the file extension: characters/monsters.txt becomes __characters/monsters__.
Click Refresh in the wildcard browser after external file changes.
A bare leaf name works only when it is unambiguous across the library.

</details> <details> <summary>Combinatorial mode creates too many runs</summary>

Check Estimated output before queueing. Reduce the wildcard sizes, mark groups that should make only one pick, or set a lower max_prompts value.

</details> <details> <summary>Weights appear as literal text</summary>

Confirm the selected mode matches the connected text encoder. Standard ComfyUI CLIP can interpret explicit weighted syntax; Qwen/LLM-style encoders generally need clean prose plus a compatible downstream weighting patcher.

</details>

Compatibility

Native spelling suggestions depend on the browser/Desktop spellchecker and installed language dictionaries. Use Alt/Option+right-click inside prompt text to access them.

ComfyUI Nodes 1.x and 2.x
ComfyUI Desktop and portable installations
.txt, .yaml, and .yml wildcard libraries
Large nested wildcard libraries with cached/background scanning

When reporting a bug, include a minimal workflow, exact reproduction steps, console output, ComfyUI/frontend versions, node mode, and Desktop vs. portable.

Credits

Prompt Palette builds on work and conventions from:

ComfyUI and the ComfyUI community — the node-based creative platform and ecosystem.
Adi Eyal / Dynamic Prompts — the wildcard and dynamic-prompt conventions that inspired much of the supported syntax.
Jtkelm2 and AUTOMATIC1111 contributors — early text-file prompt replacement workflows and conventions.

By z3rofeels.

<a href="https://github.com/z3rofeels/comfyui-promptpalette/issues">Report a bug</a> · <a href="https://github.com/z3rofeels/comfyui-promptpalette/discussions">Start a discussion</a> · <a href="https://github.com/z3rofeels/comfyui-promptpalette">Star Prompt Palette</a>

Prompt Palette

Nodes (3)

Recent updates — 2.0.7

Library thumbnails, everywhere you browse

A clearer prompting sidebar

Editing and visual autocomplete

MOSS-Image prompting

Compare one prompt change at a time

More visual sidebar browsing

Recent features — 2.0.6

Prompt Palette in the main sidebar

Offline style gallery & Anima artists

Fields that vary during generation

Library editing that keeps your place

More flexible controls & syntax help

Recent features — 2.0.5

Booru autocomplete & custom words

Adjustable prompt workspace & selective variation

Customizable toolbar

Import prompts from images

Choices, rules & prompt inspector

Editing & library improvements

Standard ComfyUI

Wildcard library location

The 30-second tour

Wildcard-first editing

Prompt workspace & toolbar

Recover a prompt from an image

Prompt Library, recipes, and stash

Main sidebar & style explorer

Edit a library entry

Starter Packs

Optional Power Tools

Optional encoder and workflow sockets

Themes and accessibility

Choose a generation mode

Controls

What expands—and what does not

Outputs and fan-out

Input syntax

Weighting modes

Outputs

Advanced controls

Recommended wiring

Everyday syntax

Conditional prompt blocks

% inside Prompt Palette vs. the Combinatorial node

Booru autocomplete & custom words

Anima artist search

Autocomplete settings

Filter by category

Readable suggestions

Add, import & export custom words

Keyboard and mouse shortcuts

Troubleshooting

Compatibility

Credits

`%` inside Prompt Palette vs. the Combinatorial node