Skip to main content
Workflows are execution instances that can be created from templates or standalone JSON files. They represent actual jobs that get processed by your runners and generate outputs.

​
Key Characteristics

Workflows provide flexible execution with comprehensive management capabilities:

​
Tag-based Scheduling

Workflows with tags only run on runners with matching tags. This ensures your workflows execute on runners with the appropriate hardware or capabilities.
If a workflow has multiple tags, ComfyControl will schedule it on a runner that have all matching tag. When multiple runners match, one is selected at random. Workflows without tags act as wildcard workflows and can run on any available runner.

​
Persistent Outputs

Results are stored independently of runner lifecycle. Even if a runner goes offline or is removed, your workflow outputs remain accessible in the gallery and workflow details.
Outputs are copied and stored persistently after workflow execution completes, ensuring your generated content is always available.

​
Re-execution

Change parameters and run workflows again with different inputs. This is particularly useful for:
  • Testing different prompts or settings
  • Iterating on successful generations
  • Exploring variations of a workflow
Re-execute workflows to experiment with different parameters without creating a new workflow from scratch.

​
Status Tracking

Real-time monitoring of execution progress and state. Track your workflow through each stage of the lifecycle with live updates and detailed state information.

​
Workflow Lifecycle

Workflows progress through multiple states from submission to completion. Understanding the lifecycle helps you monitor execution and troubleshoot issues.

​
Workflow States

  • Accepted: Validation passed and workflow is ready for processing
  • Uploaded: User inputs and workflow data have been uploaded to a runner
  • Queued: Submitted to a runner and waiting in its queue. You’ll receive real-time updates with the queue position to track progress
  • Running: Actively executing on a runner
  • Completed: Successfully finished with outputs generated
  • Failed: Execution encountered an error at any stage
  • Cancelled: Workflow was cancelled by user request
Due to the nature of ComfyUI APIs, a cancelled workflow in the queue will only be cancelled when it’s about to start running. ComfyUI does not allow removing items that are already queued.

​
Workflow Execution Flow

Understanding how workflows execute helps you optimize your setup and troubleshoot issues:
  1. Placeholder Replacement: All placeholders in the workflow are replaced with provided or generated values before submission
  2. Runner Selection: ComfyControl selects an appropriate runner based on workflow tags and runner availability
  3. Workflow Execution: The workflow executes on the selected runner, processing your AI generation task
  4. Output Storage: Outputs are copied from the runner and stored persistently in ComfyControl
The entire execution flow is tracked in real-time, allowing you to monitor progress and quickly identify any issues.