📝 PromptFlow

Modular Prompt Engineering for ComfyUI

Features | Installation | Wildcards | Variations | Examples | Support

---

See It In Action

Simple Mode + Presets + Auto-Sort - Quick prompting with built-in presets

Variations Preview - See all wildcard combinations before generating

LoRA Manager + Saving Presets - Trigger words integration and custom presets

---

PromptFlow is a free and open source ComfyUI custom node that organizes your prompt workflow. Build structured prompts with wildcards, presets, and intelligent auto-sorting!

• 📝 Two Modes - Simple (3 fields) or Extended (11 fields) for any workflow
• 🎲 Wildcards - {option1|option2|option3} syntax with 4 selection modes
• 📁 File Wildcards - __folder/filename__ loads from ComfyUI/wildcards/
• 🔀 Auto-Sort - Paste any prompt, auto-distribute to categories
• 🎯 Variations Node - Preview all combinations before generating
• 💾 Presets - Built-in + custom presets with export/import
• 🎨 7 Themes - Shared theme system with FlowPath
• 🔗 LoRA Manager - Trigger words integration

---

✨ Key Features

| Feature | Description | |---------|-------------| | 📝 Simple Mode | 3 focused fields: Main Prompt, Style, Quality | | 📋 Extended Mode | 11 granular fields: Subject, Character, Expression, Outfit, Pose, Location, Style, Camera, Lighting, Quality, Custom | | 🎲 Wildcards | {a\|b\|c} inline syntax + __file__ wildcard files | | 🔒 Field Modes | Fixed, Random, Increment, Decrement per field | | 🎯 Variations Node | See all possible combinations with seed hints | | 🔀 Auto-Sort | Paste prompts, auto-categorize with 200+ keywords | | ↕️ Drag & Drop | Reorder extended mode fields | | 💾 Presets | 22 built-in + unlimited custom presets | | 📤 Export/Import | Share presets as JSON | | 🔗 LoRA Manager | Auto-prepend trigger words | | 🎨 7 Themes | Synced with FlowPath | | ⌨️ Shortcuts | Ctrl+Z undo, right-click menus |

---

🚀 Quick Start

Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "PromptFlow"
3. Click Install
4. Restart ComfyUI

Method 2: Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/maartenharms/comfyui-promptflow

Then restart ComfyUI.

Method 3: Manual Download

1. Download the latest release ZIP
2. Extract to ComfyUI/custom_nodes/comfyui-promptflow
3. Restart ComfyUI

Basic Usage

1. Add PromptFlow node to your workflow (under "📝 PromptFlow" category)
2. Fill in prompt fields - Or use Auto-Sort to paste existing prompts
3. Connect outputs:
   • positive → CLIP Text Encode (positive)
   • negative → CLIP Text Encode (negative)
4. Generate!

---

🎲 Wildcard System

Inline Wildcards

Use {option1|option2|option3} in any field:

a {beautiful|elegant|stunning} {woman|lady} in a {forest|garden|meadow}

File Wildcards

Use __folder/filename__ to load from text files:

__characters/fantasy__ wearing __outfits/medieval__

Place .txt files in ComfyUI/wildcards/ folder (one option per line).

Field Modes

Each field can have its own mode:

| Mode | Behavior | |------|----------| | 🔒 Fixed | Always uses first option | | 🎲 Random | Random selection (seed-based) | | 📈 Increment | Cycles forward through options | | 📉 Decrement | Cycles backward through options |

---

🎯 Variations Node

The PromptFlow Variations node shows all possible prompt combinations:

1. Connect prompt_data output → Variations node input
2. See total combinations (e.g., "24 variations from 3 wildcards")
3. Click rows to select specific variations
4. Shift+click for range selection
5. Queue Selected to generate only chosen variations

Perfect for batch generation with specific combinations!

---

🔀 Auto-Sort

Paste any prompt and auto-distribute to the right categories:

1. Click the ☰ menu → Auto-Sort
2. Paste your prompt
3. Preview shows categorization
4. Click Apply

Works in both Simple and Extended modes!

---

💾 Preset System

Built-in Presets

• 10 Style Presets - Photorealistic, Cinematic, Anime, Oil Painting, etc.
• 5 Quality Presets - Standard, Ultra, Minimal, Photo, Artistic
• 7 Negative Presets - Standard, Anatomy Fix, Full, NSFW Filter, etc.

Custom Presets

• Save button on each field to save content
• Load button to apply presets
• Right-click fields for quick save
• Global Presets save entire prompt state

Export/Import

Share presets via ☰ menu → Export/Import Presets

---

🔗 LoRA Manager Integration

PromptFlow integrates seamlessly with LoRA Manager:

[LoRA Manager] --trigger_words--> [PromptFlow] --positive--> [CLIP Encode]

Trigger words are automatically prepended to your positive prompt.

---

📋 Node Reference

PromptFlow (Main Node)

Inputs: | Input | Type | Description | |-------|------|-------------| | seed | INT | For deterministic wildcard selection | | trigger_words | STRING | From LoRA Manager (optional) | | input_prompt | STRING | Prepend to output (optional) |

Outputs: | Output | Type | Description | |--------|------|-------------| | positive | STRING | Combined positive prompt | | negative | STRING | Negative prompt | | prompt_data | STRING | For Variations node |

PromptFlow Variations

Inputs: | Input | Type | Description | |-------|------|-------------| | prompt_data | STRING | From PromptFlow's prompt_data output |

Shows all wildcard combinations with selection and batch queuing.

---

🎨 Themes

Choose from 7 beautiful themes in Settings → PromptFlow → Theme:

| Theme | Primary | Accent | Vibe | |-------|---------|--------|------| | 🌊 Ocean Blue | Blue | Teal | Cool ocean waves | | 🌲 Forest Green | Green | Amber | Lush nature | | 🎠 Pink Pony Club | Hot Pink | White | Fun and playful | | 🧡 Odie | Orange | Sandy Tan | Warm and friendly | | 💜 Umbrael's Umbrage | Purple | Gold | Regal and mysterious (DEFAULT) | | ⚪ Plain Jane | Gray | Gray | Simple and minimal | | 🦇 The Dark Knight | Black | Yellow | For when Gotham needs you |

Note: Themes are shared with FlowPath!

---

⌨️ Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Ctrl+Z | Undo | | Ctrl+Y | Redo | | Escape | Close modal/dropdown | | Right-click | Context menu (Copy, Paste, Save, Clear) |

---

📁 Example Workflows

Check out the examples folder for ready-to-use workflows:

• PromptFlow Example Workflow (Simple).json - Basic 3-field workflow
• PromptFlow Example Workflow (Extended Mode with Wildcards & Variations).json - Full featured
• PromptFlow Example Workflow (LoRA Manager Integration).json - Trigger words workflow

All workflows include explanatory notes to help you get started!

---

🛠️ Troubleshooting

PromptFlow node not appearing

1. Make sure you extracted to ComfyUI/custom_nodes/comfyui-promptflow
2. Restart ComfyUI completely
3. Check console for errors (search for "PromptFlow")

Wildcards not expanding

1. Check syntax: {option1|option2} for inline, __filename__ for files
2. For file wildcards, ensure .txt file exists in ComfyUI/wildcards/
3. Check field mode is set to Random/Increment (not Fixed)

Auto-Sort not categorizing correctly

1. Auto-Sort uses keyword matching - some tags may be ambiguous
2. Review the preview before applying
3. Manually adjust categories as needed after applying

Theme not applying

1. Go to Settings → 📝 PromptFlow → Theme
2. Select your theme
3. Node should update instantly
4. If not, try reloading ComfyUI browser tab

---

💝 Support Development

PromptFlow is 100% free and open source

If you find it useful, consider supporting development:

☕ Ko-fi: https://ko-fi.com/maartenharms
⭐ Star the repo: https://github.com/maartenharms/comfyui-promptflow
📣 Share with others: Help spread the word!

Every donation helps support continued development and new features

---

🤝 Contributing

PromptFlow is open source and welcomes contributions! Whether you're fixing bugs, adding features, or improving documentation, we'd love your help.

How to Contribute

1. Report Bugs - Open an issue describing the problem
2. Request Features - Share your ideas for new features
3. Submit Code - Fork, code, and submit a Pull Request
4. Improve Docs - Fix typos, add examples, clarify instructions

Contribution Ideas

• ✅ Add new auto-sort keywords
• ✅ Create new preset packs
• ✅ Improve wildcard parsing
• ✅ Fix bugs and improve performance
• ✅ Enhance documentation
• ✅ Add new field types

---

📜 License

MIT License - Free to use, modify, and distribute

Copyright (c) 2026 Maarten Harms

See LICENSE file for full details.

---

🔗 Also By Me

| Extension | Description | |-----------|-------------| | FlowPath | Intelligent path organization for ComfyUI - A1111-style counter, template variables, auto-detection, and 7 shared themes |

---

🙏 Credits

Created by Maarten Harms (Mern)

Special thanks to:

• The ComfyUI community for feedback and support
• Everyone who helped test and improve PromptFlow
• Contributors who help make PromptFlow better
• Users who share their workflows and presets

---

📞 Contact & Links

• 🐙 GitHub: https://github.com/maartenharms/comfyui-promptflow
• ☕ Ko-fi: https://ko-fi.com/maartenharms
• 💬 Discord: @itsmern
• 📧 Issues: https://github.com/maartenharms/comfyui-promptflow/issues

---

Made for the ComfyUI community 📝

Write better prompts - generate better images!