ComfyUI-ResolutionHelper Introduction
ComfyUI-ResolutionHelper provides nodes for choosing image dimensions and working with aspect ratios in ComfyUI. It is designed for artists who find it easier to think in familiar labels such as 720p or 1080p than to enter a width, height, or megapixel value first.
The key idea is a pixel budget. Choosing 720p tells the helper to work with approximately the same number of pixels as a 1280 × 720 image. It does not require the result to be exactly 1280 × 720. You can choose an aspect ratio to shape the image while keeping that pixel budget as the starting point.
The extension also offers an Aspect Ratio Selector with additional choices, including 16:10, which the author found missing from many other selection nodes.
Overview of the seven ResolutionHelper nodes
How ComfyUI-ResolutionHelper Works
Think of the pixel budget as an allowance for the image’s total area, and the aspect ratio as the shape of the canvas. You can make a canvas wider or taller while aiming to use roughly the same number of pixels overall.
For example, 1280 × 720 contains 921,600 pixels. Selecting 720p uses that total as its reference. If you choose a different aspect ratio, the helper can return a different width and height that aim for a similar total. This lets you explore different compositions without treating “720p” as a fixed landscape size.
The multiple input affects the dimensions returned by the helper: it rounds both width and height down to the nearest multiples of the value you enter. This means the final dimensions, and therefore the final pixel count, may be lower than the initial pixel budget.
ComfyUI-ResolutionHelper Features
- Resolution selection by vertical-resolution label: Start with a label such as 720p or 1080p instead of calculating dimensions yourself. The label represents a pixel budget, not a promise of one exact width and height.
- Aspect Ratio Selector: Choose the shape that suits your composition. The selector includes additional options such as 16:10.
- Dimension rounding with
multiple: Set the increment used for width and height. For example, withmultipleset to 8, a calculated width of 1,283 rounds down to 1,280. The same rule applies to height. - Consistent aspect ratio during upscaling: The author’s example uses a single Aspect Ratio Selector so the rendered image and the upscale calculation use the same aspect ratio. This helps keep both stages aligned.
Example workflow for calculating an upscale factor
The original documentation shows seven nodes in its overview image, but does not name or describe each one individually. Refer to the node overview above for the available nodes rather than assuming that every node serves the same purpose.
Troubleshooting ComfyUI-ResolutionHelper
I selected 720p, but the result is not 1280 × 720. Is something wrong?
No. In this extension, 720p refers to the pixel count of a 1280 × 720 image, not necessarily its exact dimensions. Check the selected aspect ratio if the image is wider or taller than you expected.
Why are the dimensions or total pixel count slightly smaller than expected?
Check the multiple input. The helper rounds width and height down to the nearest multiples of that value, which can reduce the final pixel count.
My rendered and upscaled images do not have the same shape. What should I check?
Compare the aspect-ratio choices used for both stages. The author’s example uses one Aspect Ratio Selector for the render and upscale calculation so they share the same setting; the workflow image above shows this arrangement.
Learn More about ComfyUI-ResolutionHelper
The two images in this README are the provided visual references: the seven-node overview shows the extension’s nodes, and the upscale-factor example shows how the author keeps the aspect ratio consistent across a render and an upscale calculation.
