QuadFix workflows: step-by-step recipes
Each workflow uses the tools exactly as they are named in the QuadFix sidebar tab. Open it with N. The options are explained in the panel reference. After every step, read the result line at the bottom of the panel, and use Ctrl+Z (Cmd+Z on Mac) if you do not like the result.
Close holes with Fill Holes with Quads
Use this for deleted faces, scan gaps and openings in imported meshes.
- Select the mesh and press
Tabfor Edit Mode. - Press Select Non-Quads & Holes. Boundary edges are selected and the panel shows how many there are.
- Reduce the selection to the holes you want to close. Fill Holes only closes a hole when its whole boundary loop is selected, so a half-selected hole is skipped. Be careful: every fully selected closed loop is filled, including openings that are meant to be open.
- Leave Only Selected on. Leave Grid Span at 0 for an automatic choice.
- Press Fill Holes with Quads.
- Read the result, for example
Filled 3 loop(s). Now: ... quads / ... tris / ... n-gons.


If the mesh around the hole is made of triangles, the patch is triangulated as well so it matches. To get quads anyway, untick Match Triangle Meshes and run it again from undo. For the manual way to do this in Blender, read fill a hole with quads.
Bridge two edge loops
Use this to connect two openings, or two open chains of edges, when they have different numbers of edges.
- Press
Tabfor Edit Mode and switch to Edge select mode (press2). - Select the first loop with
Altand click, then add the second one withShift+Altand click. Both sides must be open (boundary) edges. - Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.
- Press Bridge to Quads.
- Open the Adjust Last Operation panel. Leave Auto Cuts on for roughly square quads, or switch it off and set Cuts. Raise Smoothness if the two sides are tilted against each other and you want the strip to follow the surface.
- The new strip is selected. The report says how many quads, rows and reductions were made.
If the total number of edges on the two sides is odd, one triangle remains and the report says so. If the tool refuses, it selects the edges that caused the problem and tells you why. See troubleshooting.
Clean up after a Boolean or an import
Use this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.
- Apply the Boolean modifier if it is still a modifier.
- Press
Taband then Select Non-Quads & Holes to see the state of the mesh. Note the counts. - Select the whole mesh with
A, or select only the area around the cut. - Check Merge Distance. The default 0.0001 suits objects of ordinary size. Raise it if doubles survive on a large model, lower it on a very small one.
- Leave Keep Sharp Edges on if you have marked sharp edges or seams that must survive.
- Press Clean & Quad (Boolean Prep).
- Read the result: vertex count, then quads, triangles and n-gons before and after.


The guide to cleaning up an imported STL goes through the same steps on a full import.
Convert triangles and n-gons to quads
Use this on triangulated scans, imported meshes or n-gons you want to subdivide.
- In Edit Mode, press Select Non-Quads & Holes to see how many triangles and n-gons there are.
- Select the faces to convert, or press
A. - Decide about flat n-gons. Keep Planar N-gons is on by default and leaves them alone, which is right for CAD surfaces and flat caps. Switch it off for scans.
- Press N-gons to Quads.
- Look at the result, for example
n-gons 4→0, tris 120→8, quads 300→412. For fewer triangles, switch on Aggressive Quads or raise Face Angle and Shape Angle, undo, and run it again. For more regular quads, lower them.
Faces that are still triangles after the run are triangles QuadFix could not pair without breaking the limits you set. Select them with Select Non-Quads & Holes. More detail in convert n-gons to quads.
Union meshes with a clean seam
Use this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.
- In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.
- In the Union (Object Mode) panel, press Union to Quads.
- Open Adjust Last Operation. Leave Rings on Auto unless a seam came out badly. Raise Max Shape Change % only if the report says seams were left as a plain Boolean and you accept a larger shape change.
- Read the result: how many seam loops were rebuilt and how many were left as a plain Boolean, plus the quad, triangle and n-gon counts.
- The other objects are hidden. Use Object > Show/Hide > Reveal Hidden to bring them back, or switch off Keep Originals Hidden to delete them.
Both meshes should be closed and should overlap. If they do not intersect, nothing is changed and you get a warning. UVs are not generated for the new strip.
Check your work
Press Select Non-Quads & Holes at the end. The footer shows the remaining non-quad faces and boundary edges. For an open mesh such as a plane, the outer rim always counts as boundary edges.
Related
- Product page: QuadFix
- Troubleshooting
- Guides: fill a hole with quads, convert n-gons to quads and clean up an imported STL