ComfyUI Canvas (LiteGraph) Settings
Detailed description of ComfyUI graphics rendering engine LiteGraph setting options
LiteGraph is the underlying graphics rendering engine of ComfyUI. The settings in this category mainly control the behavior and appearance of graphical interfaces such as canvas, nodes, and links.
Canvas
Show selection toolbox
- Default Value: Enabled
- Function: The selection toolbox is a floating quick action toolbar that appears on nodes after they are selected, providing common quick operations such as partial execution, pinning, deletion, color modification, etc.
Low quality rendering zoom threshold
- Default Value: 0.6
- Range: 0.1 - 1.0
- Function: When rendering the interface, especially when the workflow is particularly complex and the entire canvas is particularly large, the frontend rendering of corresponding elements will consume a lot of memory and cause lag. By lowering this threshold, you can control elements to enter low quality rendering mode when scaled to a specific percentage, thereby reducing memory consumption. The corresponding different rendering modes are shown below
Maximum FPS
- Default Value: 0 (use screen refresh rate)
- Range: 0 - 120
- Function: Limits the rendering frame rate of the canvas. 0 means using the screen refresh rate. Higher FPS will make the canvas rendering smoother, but will also consume more performance. Too low values will cause more obvious stuttering.
Always snap to grid
- Default Value: Disabled
- Function: When this option is not enabled, you can hold the
Shift
key to align node edges with the grid. When enabled, node edges will automatically align with the grid without holding theShift
key.
Snap to grid size
- Range: 1 - 500
- Function: When auto-snap is enabled or when moving nodes while holding the
Shift
key, this parameter determines the grid size for snapping. The default value is 10, and you can adjust it according to your needs.
Enable fast-zoom shortcut (Ctrl + Shift + Drag)
- Default Value: Enabled
- Function: Enables the
Ctrl + Shift + Left Mouse Button Drag
fast zoom function, providing a faster zoom operation method
Show graph canvas menu
- Default Value: Enabled
- Function: Controls whether to display the canvas menu in the bottom right corner
The canvas menu is located in the bottom right corner of the entire ComfyUI interface, containing operations such as canvas zooming, temporarily hiding all connections, quickly scaling the workflow to fit the canvas, etc., as shown in the image below
Canvas zoom speed
- Default Value: 1.1
- Range: 1.01 - 2.5
- Function: Controls the speed of canvas zooming, adjusts the sensitivity of mouse wheel zooming
Show canvas info on bottom left corner (fps, etc.)
- Default Value: Enabled
- Function: Controls whether to display canvas information in the bottom left corner, showing performance metrics like FPS
Context Menu
Scale node combo widget menus (lists) when zoomed in
- Default Value: Enabled
- Function: Controls whether to scale node combo widget menus (lists) when zoomed in, allowing users to select node combo widgets
Graph
Link Render Mode
- Default Value: 2 (Spline)
- Options: Straight, Linear, Spline, Hidden
- Function: Sets the rendering style of connections, controlling the visual style of links between nodes
Group
This section of settings is mainly related to node group functionality
Double click group title to edit
- Default Value: Enabled
- Function: Controls whether you can double-click the node title to edit it, allowing users to rename nodes, marked as part
1
in the image
Group selected nodes padding
- Default Value: 10
- Range: 0 - 100
- Function: Sets the inner padding when grouping selected nodes, controlling the spacing between the group frame and nodes, marked as the arrow annotation part
2
in the image
Link
Link midpoint markers
- Default Value: Circle
- Options: None, Circle, Arrow
- Function: Sets the marker style at link midpoints, displaying direction indicators at link midpoints
Link Release
This menu section currently mainly controls related operations when link connections are released. The current two related operations are:
A node recommendation list related to the current input/output will appear after release
A search box will be launched after release
Action on link release (Shift)
- Default Value: search box
- Options: context menu, search box, no action
- Function: Sets the action when releasing links while holding the Shift key, special behavior when releasing links while holding Shift
Action on link release (No modifier)
- Default Value: context menu
- Options: context menu, search box, no action
- Function: Sets the default action when releasing links, controls the behavior after dragging and releasing links
Node
Always shrink new nodes
- Default Value: Enabled
- Function: Controls whether to automatically shrink when creating new nodes, so nodes can always display the minimum size, but may cause some text display to be truncated when adding, requiring manual adjustment of node size
Enable DOM element clipping (enabling may reduce performance)
- Default Value: Enabled
- Function: Enables DOM element clipping (may affect performance), optimizes rendering but may reduce performance
Middle-click creates a new Reroute node
- Default Value: Enabled
- Function: Creates a new reroute node when middle-clicking, quickly creates reroute nodes for organizing connections
Keep all links when deleting nodes
- Default Value: Enabled
- Function: Automatically bypasses connections when deleting intermediate nodes, attempts to reconnect input and output links when deleting nodes
Snap highlights node
- Default Value: Enabled
- Function: Highlights nodes when dragging links to them, provides visual feedback, shows connectable nodes. When enabled, the effect is as shown in the image below, the corresponding side of the link will display highlighted style
Auto snap link to node slot
- Default Value: Enabled
- Function: Automatically snaps to available slots when dragging links to nodes, simplifies connection operations, automatically finds suitable input slots
Enable Tooltips
- Default Value: Enabled
- Function: Some node information will contain tooltips, including parameter descriptions, etc. When enabled, these tooltips will be displayed when hovering the mouse, as shown in the image below
Tooltip Delay
- Default Value: 500
- Function: Controls the delay time for tooltips, in milliseconds. Setting to 0 means displaying tooltips immediately
Node life cycle badge mode
- Default Value: Show all
- Function: Controls the display of node lifecycle markers, showing node status information
Node ID badge mode
- Default Value: Show all
- Function: Controls the display of node ID markers, showing node unique identifiers
Node source badge mode
- Options:
- None
- Hide built-in
- Show all
- Function: Controls the display mode of node source markers, showing node source information. The corresponding display effect is shown in the image below. If show all is selected, it will display labels for both custom nodes and built-in nodes, making it convenient for you to determine the corresponding node source. The corresponding fox logo represents ComfyUI built-in nodes
Double click node title to edit
- Default Value: Enabled
- Function: Controls whether you can double-click the node title to edit it, allowing users to rename nodes
Node Widget
Float widget rounding decimal places [0 = auto]
- Default Value: 0 (auto)
- Range: 0 - 6
- Function: Sets the decimal places for float widget rounding, 0 means auto, requires page reload
Disable default float widget rounding
- Default Value: Disabled
- Function: Controls whether to disable default float widget rounding, requires page reload, cannot be disabled when the node backend has set rounding
Disable node widget sliders
- Default Value: Disabled
- Function: Controls whether to disable slider controls in node widgets, forcing text input instead of sliders
Preview image format
- Default Value: Empty string (use original format)
- Function: Sets the format for preview images in image widgets, converts to lightweight formats like webp, jpeg, etc.
Show width × height below the image preview
- Default Value: Enabled
- Function: Displays width × height information below image previews, showing image dimension information
Pointer
Enable trackpad gestures
- Default Value: Enabled
- Function: This setting enables trackpad mode for the canvas, allowing two-finger pinch zoom and drag.
Double click interval (maximum)
- Default Value: 300
- Function: Maximum time (milliseconds) between two clicks of a double-click. Increasing this value helps solve issues where double-clicks are sometimes not recognized.
Pointer click drift delay
- Default Value: 150
- Function: Maximum time (milliseconds) to ignore pointer movement after pressing the pointer button. Helps prevent accidental mouse movement when clicking.
Pointer click drift (maximum distance)
- Default Value: 6
- Function: If the pointer moves more than this distance while holding the button, it is considered a drag (rather than a click). Helps prevent accidental mouse movement when clicking.
Reroute
Reroute spline offset
- Default Value: 20
- Function: Used to determine the smoothness of curves on both sides of reroute nodes. Larger values make curves smoother, smaller values make curves sharper.