Troubleshooting

A Few Quads Need a Touch-Up

See The result. If it happens again:

Where	Try
Ear rims, fingertips, eyelids	More Quads, or paint the part Denser.
Between fingers, at the lips	Join Touching.
A hole somewhere	1 % more or fewer Quads.

The Flow Is Not Where It Should Be

Draw a loop where the flow should go and remesh.

"Your patches were not used"

A patch folded at the red mark.

At the red mark	Try
Two lines close together	Glue one onto the other, or press Part.
A thin wedge-shaped patch	Move a corner, or add a line across it.
A deep fold (between the lips)	Move the line so the patch stays on one side of the fold.

The Remesh Takes Long

More quads and bigger meshes take longer. Blender stays usable, and Esc cancels.

The Engine Is Blocked on First Run

The engine is not signed yet, so the system warns once. It is safe to allow.

macOS: press Remesh, then Done (not Move to Trash). Open System Settings ‣ Privacy & Security, press Open Anyway next to quadguide, and press Remesh again.

If there is no Open Anyway button, type xattr -d com.apple.quarantine in Terminal (with a space at the end), drag the engine file quadguide from the add-on's quadguide/bin/macos-universal/ folder into the window, and press Enter.

Windows: when "Windows protected your PC" shows, press More info, then Run anyway.

Reporting a Problem

Press Report a Problem in the panel's Help section. It saves a zip with the last run, including the mesh and the guides, and starts an email to support; attach the zip. If the mesh cannot be shared, say so and leave the zip out.

More help: Support.