[{"data":1,"prerenderedAt":3950},["ShallowReactive",2],{"\u002Faddons\u002Fquadfix":3,"\u002Faddons\u002Fquadfix-guides":272,"\u002Faddons\u002Fquadfix-docs":1945},{"id":4,"title":5,"blender":6,"body":7,"buy":247,"description":254,"extension":255,"lite":256,"meta":258,"name":32,"navigation":259,"path":260,"poster":261,"price":262,"problem":263,"rawbody":264,"seo":265,"status":266,"stem":267,"updated":268,"version":269,"video":270,"__hash__":271},"addons\u002Faddons\u002Fquadfix.md","QuadFix: Blender quad fill & cleanup add-on","4.2 and newer",{"type":8,"value":9,"toc":236},"minimark",[10,15,19,22,26,34,74,88,95,101,105,108,122,130,134,142,146,169,173,190,194,219],[11,12,14],"h2",{"id":13},"the-problem","The problem",[16,17,18],"p",{},"You cut a hole with a Boolean and the cut edge is a ragged line of triangles and n-gons. You import an STL, an OBJ or a CAD export and half the surface is triangles. You delete a few faces on a scan and now there is a gap that Grid Fill refuses to close, because the loop has an odd number of edges. Blender has tools for each of these, but each one stops at a limit you only find by trying.",[16,20,21],{},"QuadFix is one panel that covers these cases. You select the mess, press a button, and read a short report of what changed. Every step is a normal Blender undo step.",[11,23,25],{"id":24},"what-quadfix-does","What QuadFix does",[16,27,28,29,33],{},"The tools live in the ",[30,31,32],"strong",{},"QuadFix"," tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.",[35,36,37,44,50,56,62,68],"ul",{},[38,39,40,43],"li",{},[30,41,42],{},"Fill Holes with Quads"," closes open holes and closed boundary loops with a quad grid that continues the mesh around it, instead of a triangle fan or one big flat face. Odd edge counts, irregular outlines and band-shaped gaps between two loops are handled. Use it for deleted faces, scan holes and ripped game models.",[38,45,46,49],{},[30,47,48],{},"Bridge to Quads"," joins two selected edge loops, or two open edge chains, with a strip of quads, even when they have different numbers of edges (up to 4 to 1). Use it where Blender's Bridge Edge Loops leaves triangles or a twisted strip.",[38,51,52,55],{},[30,53,54],{},"N-gons to Quads"," triangulates curved n-gons and joins triangles into quads with adjustable angles. Flat n-gons stay as they are by default, so clean CAD faces are not touched.",[38,57,58,61],{},[30,59,60],{},"Clean & Quad (Boolean Prep)"," merges doubles, removes degenerate and loose geometry, dissolves leftover junk with a limited dissolve, joins triangles into quads and recalculates normals. Use it right after a Boolean or an import.",[38,63,64,67],{},[30,65,66],{},"Select Non-Quads & Holes"," selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.",[38,69,70,73],{},[30,71,72],{},"Union to Quads"," runs an exact Boolean union of two or more mesh objects and rebuilds the seam as a strip of quads. The originals are hidden, not deleted. This one works in Object Mode.",[16,75,76,77,82,83,87],{},"Every option is described in the ",[78,79,81],"a",{"href":80},"\u002Fdocs\u002Fquadfix\u002Fpanel","panel reference",". Step-by-step recipes are in the ",[78,84,86],{"href":85},"\u002Fdocs\u002Fquadfix\u002Fworkflows","workflows page",".",[16,89,90],{},[91,92],"img",{"alt":93,"src":94},"A triangulated scan-like sphere in Blender, before N-gons to Quads, covered in a regular pattern of triangles","\u002Fmedia\u002Fquadfix-scan-to-quads-before.jpg",[16,96,97],{},[91,98],{"alt":99,"src":100},"The same sphere after N-gons to Quads: most triangles are joined into quads, a few triangles remain in red","\u002Fmedia\u002Fquadfix-scan-to-quads-after.jpg",[11,102,104],{"id":103},"what-it-does-not-do","What it does not do",[16,106,107],{},"QuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.",[35,109,110,113,116,119],{},[38,111,112],{},"Very irregular scans keep some triangles. The result line in the panel tells you how many remain.",[38,114,115],{},"Fill Holes skips the outer border of a flat open sheet, such as a plane or a terrain, and skips holes that are only partly selected.",[38,117,118],{},"Bridge to Quads refuses edge counts further apart than 4 to 1, loops that touch themselves, and selections with more than two loops or chains. Instead of guessing, it stops, selects the problem edges and leaves the mesh unchanged.",[38,120,121],{},"Union to Quads needs closed meshes that overlap. It does not generate UVs for the new strip. A seam that runs through a hole in your input stays a plain Boolean, and the report says how many seams were left that way. Strips on dense meshes with very different densities on the two sides are all quads but can zig-zag.",[16,123,124,125,129],{},"The ",[78,126,128],{"href":127},"\u002Fdocs\u002Fquadfix\u002Ftroubleshooting","troubleshooting page"," lists the messages you can see and what to do about each.",[11,131,133],{"id":132},"requirements","Requirements",[16,135,136,137,141],{},"Blender 4.2 or newer. Tested on Blender 4.2, 4.5 and 5.2. The add-on is a Blender extension, installed from a .zip file, and it needs no internet connection and no extra libraries. See ",[78,138,140],{"href":139},"\u002Fdocs\u002Fquadfix\u002Finstall","how to install QuadFix",". The licence is GPL-3.0-or-later.",[11,143,145],{"id":144},"guides","Guides",[35,147,148,155,162],{},[38,149,150,154],{},[78,151,153],{"href":152},"\u002Fguides\u002Ffill-hole-with-quads","Fill a hole with quads",": the manual way first, then the one-click way.",[38,156,157,161],{},[78,158,160],{"href":159},"\u002Fguides\u002Fngons-to-quads","Convert n-gons to quads"," and decide which n-gons to leave alone.",[38,163,164,168],{},[78,165,167],{"href":166},"\u002Fguides\u002Fclean-up-imported-stl","Clean up an imported STL"," before you sculpt, UV or print it.",[11,170,172],{"id":171},"free-quadfix-lite","Free QuadFix Lite",[16,174,175,176,182,183,186,187,87],{},"QuadFix Lite is a free, open-source cut of the add-on, available on ",[78,177,181],{"href":178,"rel":179},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite",[180],"nofollow","GitHub",". It has three tools: N-gons to Quads, Clean & Quad and Select Non-Quads & Holes, with the same options as the full version. It does not have Fill Holes with Quads, Bridge to Quads or Union to Quads, and it has no Match Triangle Meshes option. Its sidebar tab is called ",[30,184,185],{},"QuadFix Lite",", so it can sit next to the full version. A side-by-side table is on the ",[78,188,189],{"href":139},"install page",[11,191,193],{"id":192},"how-to-buy","How to buy",[16,195,196,197,202,203,208,209,213,214,218],{},"QuadFix costs $12. You can get it on ",[78,198,201],{"href":199,"rel":200},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[180],"Gumroad"," or on ",[78,204,207],{"href":205,"rel":206},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[180],"Superhive",". Both give you the same .zip. Free updates are included for the 1.x line. Questions go to ",[78,210,212],{"href":211},"mailto:support@mendboxstudio.com","support@mendboxstudio.com",". Built and tested by Pavel at Mendbox Studio (",[78,215,217],{"href":216},"\u002Fabout","about",").",[16,220,221,222,225,226,230,231,235],{},"After purchase, follow the ",[78,223,224],{"href":139},"install steps",", then open the ",[78,227,229],{"href":228},"\u002Fdocs\u002Fquadfix","documentation overview",". The ",[78,232,234],{"href":233},"\u002Fdocs\u002Fquadfix\u002Fchangelog","changelog"," lists every version.",{"title":237,"searchDepth":238,"depth":238,"links":239},"",2,[240,241,242,243,244,245,246],{"id":13,"depth":238,"text":14},{"id":24,"depth":238,"text":25},{"id":103,"depth":238,"text":104},{"id":132,"depth":238,"text":133},{"id":144,"depth":238,"text":145},{"id":171,"depth":238,"text":172},{"id":192,"depth":238,"text":193},[248,251],{"label":249,"to":250},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix",{"label":252,"to":253},"Buy on Superhive","https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix","QuadFix is a Blender add-on that fills holes with quad grids, bridges edge loops, converts n-gons and triangles to quads and cleans Boolean and imported meshes.","md",{"summary":257,"to":178},"QuadFix Lite is free and open source. It has N-gons to Quads, Clean & Quad and Select Non-Quads & Holes. Hole filling, bridging and union are in the full version.",{},true,"\u002Faddons\u002Fquadfix","\u002Fmedia\u002Fquadfix.jpg","$12","Quad hole filling and mesh cleanup in one Blender panel","---\ntitle: \"QuadFix: Blender quad fill & cleanup add-on\"\ndescription: \"QuadFix is a Blender add-on that fills holes with quad grids, bridges edge loops, converts n-gons and triangles to quads and cleans Boolean and imported meshes.\"\nname: QuadFix\nprice: \"$12\"\nstatus: released\nproblem: \"Quad hole filling and mesh cleanup in one Blender panel\"\nversion: \"1.4.5\"\nblender: \"4.2 and newer\"\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nbuy:\n  - label: Buy on Gumroad\n    to: https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix\n  - label: Buy on Superhive\n    to: https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix\nlite:\n  summary: \"QuadFix Lite is free and open source. It has N-gons to Quads, Clean & Quad and Select Non-Quads & Holes. Hole filling, bridging and union are in the full version.\"\n  to: https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite\nupdated: 2026-11-16\n---\n\n## The problem\n\nYou cut a hole with a Boolean and the cut edge is a ragged line of triangles and n-gons. You import an STL, an OBJ or a CAD export and half the surface is triangles. You delete a few faces on a scan and now there is a gap that Grid Fill refuses to close, because the loop has an odd number of edges. Blender has tools for each of these, but each one stops at a limit you only find by trying.\n\nQuadFix is one panel that covers these cases. You select the mess, press a button, and read a short report of what changed. Every step is a normal Blender undo step.\n\n## What QuadFix does\n\nThe tools live in the **QuadFix** tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.\n\n- **Fill Holes with Quads** closes open holes and closed boundary loops with a quad grid that continues the mesh around it, instead of a triangle fan or one big flat face. Odd edge counts, irregular outlines and band-shaped gaps between two loops are handled. Use it for deleted faces, scan holes and ripped game models.\n- **Bridge to Quads** joins two selected edge loops, or two open edge chains, with a strip of quads, even when they have different numbers of edges (up to 4 to 1). Use it where Blender's Bridge Edge Loops leaves triangles or a twisted strip.\n- **N-gons to Quads** triangulates curved n-gons and joins triangles into quads with adjustable angles. Flat n-gons stay as they are by default, so clean CAD faces are not touched.\n- **Clean & Quad (Boolean Prep)** merges doubles, removes degenerate and loose geometry, dissolves leftover junk with a limited dissolve, joins triangles into quads and recalculates normals. Use it right after a Boolean or an import.\n- **Select Non-Quads & Holes** selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.\n- **Union to Quads** runs an exact Boolean union of two or more mesh objects and rebuilds the seam as a strip of quads. The originals are hidden, not deleted. This one works in Object Mode.\n\nEvery option is described in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel). Step-by-step recipes are in the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows).\n\n![A triangulated scan-like sphere in Blender, before N-gons to Quads, covered in a regular pattern of triangles](\u002Fmedia\u002Fquadfix-scan-to-quads-before.jpg)\n\n![The same sphere after N-gons to Quads: most triangles are joined into quads, a few triangles remain in red](\u002Fmedia\u002Fquadfix-scan-to-quads-after.jpg)\n\n## What it does not do\n\nQuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.\n\n- Very irregular scans keep some triangles. The result line in the panel tells you how many remain.\n- Fill Holes skips the outer border of a flat open sheet, such as a plane or a terrain, and skips holes that are only partly selected.\n- Bridge to Quads refuses edge counts further apart than 4 to 1, loops that touch themselves, and selections with more than two loops or chains. Instead of guessing, it stops, selects the problem edges and leaves the mesh unchanged.\n- Union to Quads needs closed meshes that overlap. It does not generate UVs for the new strip. A seam that runs through a hole in your input stays a plain Boolean, and the report says how many seams were left that way. Strips on dense meshes with very different densities on the two sides are all quads but can zig-zag.\n\nThe [troubleshooting page](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting) lists the messages you can see and what to do about each.\n\n## Requirements\n\nBlender 4.2 or newer. Tested on Blender 4.2, 4.5 and 5.2. The add-on is a Blender extension, installed from a .zip file, and it needs no internet connection and no extra libraries. See [how to install QuadFix](\u002Fdocs\u002Fquadfix\u002Finstall). The licence is GPL-3.0-or-later.\n\n## Guides\n\n- [Fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads): the manual way first, then the one-click way.\n- [Convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and decide which n-gons to leave alone.\n- [Clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl) before you sculpt, UV or print it.\n\n## Free QuadFix Lite\n\nQuadFix Lite is a free, open-source cut of the add-on, available on [GitHub](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite). It has three tools: N-gons to Quads, Clean & Quad and Select Non-Quads & Holes, with the same options as the full version. It does not have Fill Holes with Quads, Bridge to Quads or Union to Quads, and it has no Match Triangle Meshes option. Its sidebar tab is called **QuadFix Lite**, so it can sit next to the full version. A side-by-side table is on the [install page](\u002Fdocs\u002Fquadfix\u002Finstall).\n\n## How to buy\n\nQuadFix costs $12. You can get it on [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix) or on [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix). Both give you the same .zip. Free updates are included for the 1.x line. Questions go to support@mendboxstudio.com. Built and tested by Pavel at Mendbox Studio ([about](\u002Fabout)).\n\nAfter purchase, follow the [install steps](\u002Fdocs\u002Fquadfix\u002Finstall), then open the [documentation overview](\u002Fdocs\u002Fquadfix). The [changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog) lists every version.\n",{"title":5,"description":254},"released","addons\u002Fquadfix","2026-11-16","1.4.5","\u002Fmedia\u002Fquadfix.mp4","amZYvMitLwbhp1ca_RA8Ya1NuxulM6mN0AUqALtM3qg",[273,846,1350],{"id":274,"title":275,"addon":276,"body":277,"description":840,"extension":255,"meta":841,"navigation":259,"path":166,"poster":261,"rawbody":842,"seo":843,"stem":844,"updated":268,"video":270,"__hash__":845},"guides\u002Fguides\u002Fclean-up-imported-stl.md","Clean up an imported STL or OBJ in Blender","quadfix",{"type":8,"value":278,"toc":826},[279,298,301,305,328,344,348,371,374,388,391,395,413,422,426,444,457,461,502,505,508,512,515,540,551,555,566,585,589,609,613,709,713,744,748,756,784,798,811,815],[16,280,281,282,285,286,289,290,293,294,297],{},"To clean up an imported STL or OBJ mesh in Blender, work in this order in Edit Mode: ",[30,283,284],{},"Merge by Distance"," to weld split vertices, ",[30,287,288],{},"Delete Loose"," to remove stray geometry, ",[30,291,292],{},"Recalculate Normals"," to fix inside-out faces, ",[30,295,296],{},"Select Non Manifold"," to find the holes, then fill them and simplify the triangles. Each step is a menu entry, and the order matters because the later steps depend on the mesh being welded.",[16,299,300],{},"I ran everything here on test meshes in Blender 4.2.23 and 5.2.2, and the numbers come from those runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.",[11,302,304],{"id":303},"step-1-import-the-file","Step 1: import the file",[16,306,307,308,311,312,315,316,319,320,323,324,327],{},"Choose ",[30,309,310],{},"File > Import > STL (.stl)",", or ",[30,313,314],{},"File > Import > Wavefront (.obj)"," for an OBJ. In Blender 4.2 and later the STL importer is built in, there is nothing to enable. Its options include ",[30,317,318],{},"Scale",", ",[30,321,322],{},"Scene Unit",", the forward and up axes, and ",[30,325,326],{},"Validate Mesh",". If the model arrives far too large or small, change the Scale option.",[16,329,330,331,335,336,339,340,343],{},"Then select the object, press ",[332,333,334],"code",{},"Tab",", and press ",[332,337,338],{},"A"," to select everything. Turn on ",[30,341,342],{},"Overlays > Statistics"," so you can watch the vertex, edge and face counts change.",[11,345,347],{"id":346},"step-2-merge-by-distance-m-by-distance","Step 2: Merge by Distance (M > By Distance)",[16,349,350,351,354,355,358,359,362,363,366,367,370],{},"Press ",[332,352,353],{},"M"," in Edit Mode and choose ",[30,356,357],{},"By Distance",", or use ",[30,360,361],{},"Mesh > Merge > By Distance",". The same operator is also in ",[30,364,365],{},"Mesh > Clean Up"," under the name Merge by Distance. It welds vertices that are closer together than ",[30,368,369],{},"Merge Distance"," (0.0001 by default).",[16,372,373],{},"What it does depends on the file:",[35,375,376,379,385],{},[38,377,378],{},"A clean STL may need nothing. In my test, Blender's importer already welded vertices that sit at exactly the same position: 503 triangles arrived as 260 vertices, and Merge by Distance removed 0.",[38,380,381,382,384],{},"A file whose triangles do not share exact positions arrives unwelded. I nudged every vertex of a test mesh by up to 0.0005 before exporting it. After import it had 1509 vertices (three per triangle) and every edge counted as open. Merge by Distance at the default 0.0001 removed only 14 vertices. Raising ",[30,383,369],{}," to 0.002 in the Adjust Last Operation panel removed 1235 and left 260 vertices, with only the real hole still open.",[38,386,387],{},"The distance is measured in the object's own units, before object scale. In my test, two vertices 0.001 apart on an object scaled 100 times were merged with a Merge Distance of 0.01.",[16,389,390],{},"Raise the value in small steps. Too large a distance will collapse small details together.",[11,392,394],{"id":393},"step-3-delete-loose-mesh-clean-up-delete-loose","Step 3: Delete Loose (Mesh > Clean Up > Delete Loose)",[16,396,397,398,401,402,319,405,408,409,412],{},"Scans and CAD exports often carry stray vertices and edges. ",[30,399,400],{},"Mesh > Clean Up > Delete Loose"," removes them, with the options ",[30,403,404],{},"Vertices",[30,406,407],{},"Edges"," and ",[30,410,411],{},"Faces",". In my test, 3 stray vertices and 1 stray edge added to the mesh were removed, and nothing else changed.",[16,414,415,416,418,419,421],{},"A floating triangle that is not connected to the model is not loose in this sense. With ",[30,417,411],{}," off, nothing was removed. With ",[30,420,411],{}," on, the triangle and its vertices were deleted. Turn Faces on only if you are sure those pieces are junk, since a separate shell can also be a real part.",[11,423,425],{"id":424},"step-4-recalculate-normals-shiftn","Step 4: Recalculate Normals (Shift+N)",[16,427,428,429,432,433,436,437,439,440,443],{},"Open ",[30,430,431],{},"Mesh > Normals > Recalculate Outside"," or press ",[332,434,435],{},"Shift+N",". Select the whole mesh first. In my test, I flipped the top faces of a closed 503-face mesh, so only 292 faces pointed outward. After ",[332,438,435],{},", all 503 did. Use ",[30,441,442],{},"Recalculate Inside"," only for a mesh you want to see from the inside.",[16,445,446,447,449,450,452,453,456],{},"Recalculating only works on welded faces, which is why Step 2 comes first. I tested it on an unwelded triangulated sphere, where every face had its own vertices, with the top faces flipped: 312 of 528 faces pointed outward before ",[332,448,435],{}," and 259 after, so it fixed nothing. After Merge by Distance, ",[332,451,435],{}," made all 528 point outward. Turn on ",[30,454,455],{},"Overlays > Face Orientation"," to check: blue faces point outward, red faces point inward.",[11,458,460],{"id":459},"step-5-find-the-holes-with-select-non-manifold","Step 5: find the holes with Select Non Manifold",[462,463,464,474,483],"ol",{},[38,465,350,466,469,470,473],{},[332,467,468],{},"1"," for vertex select mode or ",[332,471,472],{},"2"," for edge select mode.",[38,475,307,476,479,480,87],{},[30,477,478],{},"Select > Select All by Trait > Non Manifold",", or press ",[332,481,482],{},"Shift+Ctrl+Alt+M",[38,484,485,486,489,490,319,493,319,496,319,499,501],{},"In the Adjust Last Operation panel, keep ",[30,487,488],{},"Boundaries"," ticked, which selects the edges around open holes. The other options (",[30,491,492],{},"Wire",[30,494,495],{},"Multiple Faces",[30,497,498],{},"Non Contiguous",[30,500,404],{},") find other kinds of damage.",[16,503,504],{},"In my test, a mesh with one 15-edge hole selected exactly 15 edges. On the unwelded version, every edge was selected, which is the sign that you skipped Step 2.",[16,506,507],{},"The Non Manifold entry is not available in face select mode. The menu hides it and, in my test, calling the operator in face mode failed with an error. Switch to vertex or edge mode first.",[11,509,511],{"id":510},"step-6-fill-the-holes","Step 6: fill the holes",[16,513,514],{},"You have three built-in choices.",[35,516,517,527,534],{},[38,518,519,522,523,526],{},[30,520,521],{},"Mesh > Clean Up > Fill Holes",". It only fills holes up to the ",[30,524,525],{},"Sides"," value, which defaults to 4. The 15-edge hole was not touched at the default, and with Sides set to 64 it was closed by a single 15-sided n-gon.",[38,528,529,530,533],{},"Select the hole's edges and press ",[332,531,532],{},"F",". The result is the same n-gon.",[38,535,536,539],{},[30,537,538],{},"Face > Grid Fill"," for quads, which only works on a loop with an even number of edges.",[16,541,542,543,546,547,550],{},"Selecting one edge of the hole and then using ",[30,544,545],{},"Select > Select Loops > Edge Loops"," picks the whole hole's loop. ",[78,548,549],{"href":152},"How to fill a hole with quads in Blender"," explains Grid Fill, Bridge Edge Loops and the odd-edge-count problem in detail.",[11,552,554],{"id":553},"step-7-simplify-with-limited-dissolve","Step 7: simplify with Limited Dissolve",[16,556,557,558,561,562,565],{},"STL files are all triangles. ",[30,559,560],{},"Mesh > Clean Up > Limited Dissolve"," merges flat neighbouring faces whose angle is below ",[30,563,564],{},"Max Angle"," (5 degrees by default). On a cube whose sides were subdivided and triangulated (192 triangles), it left 6 quads and 8 vertices. On a triangulated UV sphere (528 triangles) it produced 240 quads and 12 n-gons with 5, 6 or 7 sides in Blender 5.2.2. In 4.2.23 the same test gave 248 quads and 8 six-sided n-gons. Flat areas become clean faces, but curved areas can end up with n-gons.",[16,567,568,569,572,573,576,577,580,581,584],{},"Run ",[30,570,571],{},"Face > Tris to Quads"," (",[30,574,575],{},"Triangles to Quads"," in 5.x, ",[332,578,579],{},"Alt+J",") afterwards for the remaining triangles, and see ",[78,582,583],{"href":159},"turning n-gons and triangles into quads"," for what to do with leftover n-gons.",[11,586,588],{"id":587},"the-order-in-one-list","The order in one list",[462,590,591,594,597,600,603,606],{},[38,592,593],{},"Import the file and select everything.",[38,595,596],{},"Merge by Distance, raising the distance if the surface is still open everywhere.",[38,598,599],{},"Delete Loose.",[38,601,602],{},"Recalculate Normals.",[38,604,605],{},"Select Non Manifold, then fill the holes.",[38,607,608],{},"Limited Dissolve, then Tris to Quads.",[11,610,612],{"id":611},"methods-compared","Methods compared",[614,615,616,635],"table",{},[617,618,619],"thead",{},[620,621,622,626,629,632],"tr",{},[623,624,625],"th",{},"Problem",[623,627,628],{},"Built-in step",[623,630,631],{},"What it gives",[623,633,634],{},"Limit",[636,637,638,652,665,678,695],"tbody",{},[620,639,640,644,646,649],{},[641,642,643],"td",{},"Unwelded vertices",[641,645,284],{},[641,647,648],{},"Shared vertices",[641,650,651],{},"Distance must match the gap",[620,653,654,657,659,662],{},[641,655,656],{},"Stray vertices, edges",[641,658,288],{},[641,660,661],{},"Cleaner mesh",[641,663,664],{},"Faces option can delete real shells",[620,666,667,670,672,675],{},[641,668,669],{},"Inside-out faces",[641,671,435],{},[641,673,674],{},"Consistent normals",[641,676,677],{},"Needs connected faces",[620,679,680,683,689,692],{},[641,681,682],{},"Holes",[641,684,685,686,688],{},"Fill Holes, ",[332,687,532],{},", Grid Fill",[641,690,691],{},"N-gon, or quads on even loops",[641,693,694],{},"Fill Holes stops at Sides, Grid Fill needs even loops",[620,696,697,700,703,706],{},[641,698,699],{},"Triangle soup",[641,701,702],{},"Limited Dissolve, Alt+J",[641,704,705],{},"Quads and some n-gons",[641,707,708],{},"Curved areas keep triangles or n-gons",[11,710,712],{"id":711},"what-can-go-wrong","What can go wrong",[35,714,715,721,727,735],{},[38,716,717,720],{},[30,718,719],{},"Everything is selected as non-manifold."," The mesh is unwelded. Go back to Merge by Distance with a larger distance.",[38,722,723,726],{},[30,724,725],{},"The model collapses after merging."," The distance is too large for the model's scale.",[38,728,729,732,733,87],{},[30,730,731],{},"Shading is dark in patches."," Check Face Orientation, then run ",[332,734,435],{},[38,736,737,740,741,743],{},[30,738,739],{},"Fill Holes does nothing."," The hole has more sides than the ",[30,742,525],{}," setting.",[11,745,747],{"id":746},"faster-with-quadfix","Faster with QuadFix",[16,749,750,752,753,755],{},[78,751,32],{"href":260}," has a ",[30,754,60],{}," button that runs the cleanup in one go: merge doubles, remove degenerate and loose geometry, limited dissolve, tris to quads. I tested it on Blender 4.2.23 and 5.2.2.",[462,757,758,773,779],{},[38,759,350,760,762,763,765,766,769,770,772],{},[332,761,334],{},", open the ",[30,764,32],{}," tab in the sidebar (",[332,767,768],{},"N","), and press ",[30,771,66],{}," to see how many non-quad faces and boundary edges the mesh has.",[38,774,775,776,87],{},"Select the whole mesh and press ",[30,777,778],{},"Clean & Quad",[38,780,350,781,783],{},[30,782,42],{}," for the openings.",[16,785,786,787,789,790,793,794,797],{},"On a test mesh made of 528 separate triangles with a stray vertex (1585 vertices), Clean & Quad brought it to 266 vertices and 264 quads with no triangles left, and the report showed the before and after counts. It also recalculates normals: on a closed sphere with its top faces flipped, only 168 of 288 faces pointed outward before the button and all 288 after. ",[30,788,369],{}," (0.0001 by default), ",[30,791,792],{},"Dissolve Angle"," (5 degrees) and ",[30,795,796],{},"Keep Sharp Edges"," are on the panel.",[16,799,800,801,804,805,807,808,810],{},"Know the limits. Fill Holes keeps the patch triangular when the surrounding mesh is all triangles (",[30,802,803],{},"Match Triangle Meshes",", on by default). On a fully triangulated mesh with a 15-edge hole, the default added 23 triangles and 1 quad. With the option off the result had 13 quads and 194 triangles. It repairs the mesh you have and is not a retopology tool. The ",[78,806,81],{"href":80}," lists every option and the ",[78,809,86],{"href":85}," shows the import cleanup flow. The free QuadFix Lite includes Clean & Quad and N-gons to Quads, but not hole filling.",[11,812,814],{"id":813},"related-guides","Related guides",[35,816,817,821],{},[38,818,819],{},[78,820,549],{"href":152},[38,822,823],{},[78,824,825],{"href":159},"How to turn n-gons and triangles into quads in Blender",{"title":237,"searchDepth":238,"depth":238,"links":827},[828,829,830,831,832,833,834,835,836,837,838,839],{"id":303,"depth":238,"text":304},{"id":346,"depth":238,"text":347},{"id":393,"depth":238,"text":394},{"id":424,"depth":238,"text":425},{"id":459,"depth":238,"text":460},{"id":510,"depth":238,"text":511},{"id":553,"depth":238,"text":554},{"id":587,"depth":238,"text":588},{"id":611,"depth":238,"text":612},{"id":711,"depth":238,"text":712},{"id":746,"depth":238,"text":747},{"id":813,"depth":238,"text":814},"Clean up an imported STL or OBJ in Blender: merge by distance, fix normals, find non-manifold edges, fill holes, delete loose geometry and dissolve triangles.",{},"---\ntitle: \"Clean up an imported STL or OBJ in Blender\"\ndescription: \"Clean up an imported STL or OBJ in Blender: merge by distance, fix normals, find non-manifold edges, fill holes, delete loose geometry and dissolve triangles.\"\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo clean up an imported STL or OBJ mesh in Blender, work in this order in Edit Mode: **Merge by Distance** to weld split vertices, **Delete Loose** to remove stray geometry, **Recalculate Normals** to fix inside-out faces, **Select Non Manifold** to find the holes, then fill them and simplify the triangles. Each step is a menu entry, and the order matters because the later steps depend on the mesh being welded.\n\nI ran everything here on test meshes in Blender 4.2.23 and 5.2.2, and the numbers come from those runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.\n\n## Step 1: import the file\n\nChoose **File > Import > STL (.stl)**, or **File > Import > Wavefront (.obj)** for an OBJ. In Blender 4.2 and later the STL importer is built in, there is nothing to enable. Its options include **Scale**, **Scene Unit**, the forward and up axes, and **Validate Mesh**. If the model arrives far too large or small, change the Scale option.\n\nThen select the object, press `Tab`, and press `A` to select everything. Turn on **Overlays > Statistics** so you can watch the vertex, edge and face counts change.\n\n## Step 2: Merge by Distance (M > By Distance)\n\nPress `M` in Edit Mode and choose **By Distance**, or use **Mesh > Merge > By Distance**. The same operator is also in **Mesh > Clean Up** under the name Merge by Distance. It welds vertices that are closer together than **Merge Distance** (0.0001 by default).\n\nWhat it does depends on the file:\n\n- A clean STL may need nothing. In my test, Blender's importer already welded vertices that sit at exactly the same position: 503 triangles arrived as 260 vertices, and Merge by Distance removed 0.\n- A file whose triangles do not share exact positions arrives unwelded. I nudged every vertex of a test mesh by up to 0.0005 before exporting it. After import it had 1509 vertices (three per triangle) and every edge counted as open. Merge by Distance at the default 0.0001 removed only 14 vertices. Raising **Merge Distance** to 0.002 in the Adjust Last Operation panel removed 1235 and left 260 vertices, with only the real hole still open.\n- The distance is measured in the object's own units, before object scale. In my test, two vertices 0.001 apart on an object scaled 100 times were merged with a Merge Distance of 0.01.\n\nRaise the value in small steps. Too large a distance will collapse small details together.\n\n## Step 3: Delete Loose (Mesh > Clean Up > Delete Loose)\n\nScans and CAD exports often carry stray vertices and edges. **Mesh > Clean Up > Delete Loose** removes them, with the options **Vertices**, **Edges** and **Faces**. In my test, 3 stray vertices and 1 stray edge added to the mesh were removed, and nothing else changed.\n\nA floating triangle that is not connected to the model is not loose in this sense. With **Faces** off, nothing was removed. With **Faces** on, the triangle and its vertices were deleted. Turn Faces on only if you are sure those pieces are junk, since a separate shell can also be a real part.\n\n## Step 4: Recalculate Normals (Shift+N)\n\nOpen **Mesh > Normals > Recalculate Outside** or press `Shift+N`. Select the whole mesh first. In my test, I flipped the top faces of a closed 503-face mesh, so only 292 faces pointed outward. After `Shift+N`, all 503 did. Use **Recalculate Inside** only for a mesh you want to see from the inside.\n\nRecalculating only works on welded faces, which is why Step 2 comes first. I tested it on an unwelded triangulated sphere, where every face had its own vertices, with the top faces flipped: 312 of 528 faces pointed outward before `Shift+N` and 259 after, so it fixed nothing. After Merge by Distance, `Shift+N` made all 528 point outward. Turn on **Overlays > Face Orientation** to check: blue faces point outward, red faces point inward.\n\n## Step 5: find the holes with Select Non Manifold\n\n1. Press `1` for vertex select mode or `2` for edge select mode.\n2. Choose **Select > Select All by Trait > Non Manifold**, or press `Shift+Ctrl+Alt+M`.\n3. In the Adjust Last Operation panel, keep **Boundaries** ticked, which selects the edges around open holes. The other options (**Wire**, **Multiple Faces**, **Non Contiguous**, **Vertices**) find other kinds of damage.\n\nIn my test, a mesh with one 15-edge hole selected exactly 15 edges. On the unwelded version, every edge was selected, which is the sign that you skipped Step 2.\n\nThe Non Manifold entry is not available in face select mode. The menu hides it and, in my test, calling the operator in face mode failed with an error. Switch to vertex or edge mode first.\n\n## Step 6: fill the holes\n\nYou have three built-in choices.\n\n- **Mesh > Clean Up > Fill Holes**. It only fills holes up to the **Sides** value, which defaults to 4. The 15-edge hole was not touched at the default, and with Sides set to 64 it was closed by a single 15-sided n-gon.\n- Select the hole's edges and press `F`. The result is the same n-gon.\n- **Face > Grid Fill** for quads, which only works on a loop with an even number of edges.\n\nSelecting one edge of the hole and then using **Select > Select Loops > Edge Loops** picks the whole hole's loop. [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads) explains Grid Fill, Bridge Edge Loops and the odd-edge-count problem in detail.\n\n## Step 7: simplify with Limited Dissolve\n\nSTL files are all triangles. **Mesh > Clean Up > Limited Dissolve** merges flat neighbouring faces whose angle is below **Max Angle** (5 degrees by default). On a cube whose sides were subdivided and triangulated (192 triangles), it left 6 quads and 8 vertices. On a triangulated UV sphere (528 triangles) it produced 240 quads and 12 n-gons with 5, 6 or 7 sides in Blender 5.2.2. In 4.2.23 the same test gave 248 quads and 8 six-sided n-gons. Flat areas become clean faces, but curved areas can end up with n-gons.\n\nRun **Face > Tris to Quads** (**Triangles to Quads** in 5.x, `Alt+J`) afterwards for the remaining triangles, and see [turning n-gons and triangles into quads](\u002Fguides\u002Fngons-to-quads) for what to do with leftover n-gons.\n\n## The order in one list\n\n1. Import the file and select everything.\n2. Merge by Distance, raising the distance if the surface is still open everywhere.\n3. Delete Loose.\n4. Recalculate Normals.\n5. Select Non Manifold, then fill the holes.\n6. Limited Dissolve, then Tris to Quads.\n\n## Methods compared\n\n| Problem | Built-in step | What it gives | Limit |\n| --- | --- | --- | --- |\n| Unwelded vertices | Merge by Distance | Shared vertices | Distance must match the gap |\n| Stray vertices, edges | Delete Loose | Cleaner mesh | Faces option can delete real shells |\n| Inside-out faces | Shift+N | Consistent normals | Needs connected faces |\n| Holes | Fill Holes, `F`, Grid Fill | N-gon, or quads on even loops | Fill Holes stops at Sides, Grid Fill needs even loops |\n| Triangle soup | Limited Dissolve, Alt+J | Quads and some n-gons | Curved areas keep triangles or n-gons |\n\n## What can go wrong\n\n- **Everything is selected as non-manifold.** The mesh is unwelded. Go back to Merge by Distance with a larger distance.\n- **The model collapses after merging.** The distance is too large for the model's scale.\n- **Shading is dark in patches.** Check Face Orientation, then run `Shift+N`.\n- **Fill Holes does nothing.** The hole has more sides than the **Sides** setting.\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) has a **Clean & Quad (Boolean Prep)** button that runs the cleanup in one go: merge doubles, remove degenerate and loose geometry, limited dissolve, tris to quads. I tested it on Blender 4.2.23 and 5.2.2.\n\n1. Press `Tab`, open the **QuadFix** tab in the sidebar (`N`), and press **Select Non-Quads & Holes** to see how many non-quad faces and boundary edges the mesh has.\n2. Select the whole mesh and press **Clean & Quad**.\n3. Press **Fill Holes with Quads** for the openings.\n\nOn a test mesh made of 528 separate triangles with a stray vertex (1585 vertices), Clean & Quad brought it to 266 vertices and 264 quads with no triangles left, and the report showed the before and after counts. It also recalculates normals: on a closed sphere with its top faces flipped, only 168 of 288 faces pointed outward before the button and all 288 after. **Merge Distance** (0.0001 by default), **Dissolve Angle** (5 degrees) and **Keep Sharp Edges** are on the panel.\n\nKnow the limits. Fill Holes keeps the patch triangular when the surrounding mesh is all triangles (**Match Triangle Meshes**, on by default). On a fully triangulated mesh with a 15-edge hole, the default added 23 triangles and 1 quad. With the option off the result had 13 quads and 194 triangles. It repairs the mesh you have and is not a retopology tool. The [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel) lists every option and the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows) shows the import cleanup flow. The free QuadFix Lite includes Clean & Quad and N-gons to Quads, but not hole filling.\n\n## Related guides\n\n- [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads)\n- [How to turn n-gons and triangles into quads in Blender](\u002Fguides\u002Fngons-to-quads)\n",{"title":275,"description":840},"guides\u002Fclean-up-imported-stl","LGdNC34sZ7mSiIW8f3dFZFruzcTXvAwccIxSdPQkyNo",{"id":847,"title":549,"addon":276,"body":848,"description":1344,"extension":255,"meta":1345,"navigation":259,"path":152,"poster":261,"rawbody":1346,"seo":1347,"stem":1348,"updated":268,"video":270,"__hash__":1349},"guides\u002Fguides\u002Ffill-hole-with-quads.md",{"type":8,"value":849,"toc":1328},[850,856,859,863,873,877,900,909,913,919,923,940,944,947,979,991,997,1002,1009,1013,1020,1036,1039,1043,1048,1068,1079,1083,1205,1207,1241,1243,1251,1273,1276,1305,1315,1317],[16,851,852,853,855],{},"To fill a hole with quads in Blender, select the edge loop around the hole and use ",[30,854,538],{},". It builds a quad grid across the opening, but only when the loop has an even number of edges. For a hole with an odd edge count, an irregular outline or a gap between two loops, you need one of the workarounds below, or a tool that does it in one click.",[16,857,858],{},"This guide covers each built-in method, what it produces and where it breaks. I tested every result in Blender 4.2.23 and 5.2.2 on a UV sphere with faces deleted. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.",[11,860,862],{"id":861},"why-the-default-fill-is-usually-not-what-you-want","Why the default fill is usually not what you want",[16,864,865,866,868,869,872],{},"Pressing ",[332,867,532],{}," on a closed edge loop is the obvious first move, and it works, but it creates ",[30,870,871],{},"one n-gon"," with as many sides as the loop has edges. In my test, a 12-edge hole became a single 12-sided face, and a 15-edge hole became a single 15-sided face. That is fine for a flat cap, but it shades badly on a curved surface and it is the face type you were probably trying to get rid of.",[11,874,876],{"id":875},"step-1-select-the-edges-around-the-hole","Step 1: select the edges around the hole",[462,878,879,886,889,894],{},[38,880,350,881,883,884,473],{},[332,882,334],{}," to enter Edit Mode and press ",[332,885,472],{},[38,887,888],{},"Click one edge of the hole.",[38,890,307,891,893],{},[30,892,545],{},". In my test this selected the whole boundary of that one hole and nothing else, even with a second hole on the mesh. (The menu entry is the same in 4.2 and 5.x.)",[38,895,896,897,899],{},"Turn on ",[30,898,342],{}," and read the selected edge count. You need to know whether it is even or odd.",[16,901,902,903,905,906,908],{},"If the mesh has only the one hole, you can instead use ",[30,904,478],{}," (available in vertex and edge select mode, not in face mode) and keep only ",[30,907,488],{}," ticked in the Adjust Last Operation panel. That selects every open border on the mesh, so with several holes it selects them all.",[11,910,912],{"id":911},"method-1-f-new-edgeface-from-vertices","Method 1: F (New Edge\u002FFace from Vertices)",[16,914,915,916,918],{},"With the loop selected, press ",[332,917,532],{},". The hole is closed by a single n-gon. It cannot fail, and it improves nothing. Use it only when a flat n-gon is acceptable.",[11,920,922],{"id":921},"method-2-face-fill-altf","Method 2: Face > Fill (Alt+F)",[16,924,925,926,432,929,932,933,572,935,576,937,939],{},"With the loop selected, choose ",[30,927,928],{},"Face > Fill",[332,930,931],{},"Alt+F",". Blender triangulates the hole. In my test a 12-edge loop gave 10 triangles, a 15-edge loop gave 13 and a 16-edge loop gave 14: the edge count minus two. There are no n-gons, but there are no quads either. Running ",[30,934,571],{},[30,936,575],{},[332,938,579],{},") on the result joined only a few pairs of triangles in the 16-edge test, so it is not a way to a clean grid.",[11,941,943],{"id":942},"method-3-grid-fill-ctrlf-grid-fill","Method 3: Grid Fill (Ctrl+F > Grid Fill)",[16,945,946],{},"This is the method that gives quads.",[462,948,949,952,962,969],{},[38,950,951],{},"Select the loop as above.",[38,953,350,954,957,958,961],{},[332,955,956],{},"Ctrl+F"," to open the Face menu and choose ",[30,959,960],{},"Grid Fill",", or use the Face menu in the header.",[38,963,964,965,968],{},"Open the ",[30,966,967],{},"Adjust Last Operation"," panel in the bottom-left corner of the viewport.",[38,970,971,972,408,975,978],{},"Change ",[30,973,974],{},"Span",[30,976,977],{},"Offset"," until the grid looks straight.",[16,980,981,984,985,987,988,990],{},[30,982,983],{},"Even loops work."," In my test, 12-edge and 16-edge holes were filled with quads only, with no triangles or n-gons created, and the hole's boundary was closed. ",[30,986,974],{}," controls how many rows of quads cross the hole (the result changed from 5 to 9 new faces on the 12-edge loop as Span went from 1 to 3, all of them quads). ",[30,989,977],{}," rotates where the grid starts on the loop, which helps when the result looks twisted. On the first run Blender chooses the Span itself.",[16,992,993,996],{},[30,994,995],{},"Odd loops fail."," On a 15-edge loop nothing happened. Blender only showed the message \"Select two edge loops or a single closed edge loop from which two edge loops can be calculated\". That message does not mention the real cause, which is that a single loop has to be split into two halves of equal length.",[998,999,1001],"h3",{"id":1000},"making-an-odd-loop-even","Making an odd loop even",[16,1003,1004,1005,1008],{},"Add or remove one vertex on the loop. In my test, selecting one edge of the 15-edge loop and subdividing it (",[30,1006,1007],{},"Edge > Subdivide",") made the loop 16 edges long, and Grid Fill then produced quads. The catch is that subdividing a border edge also adds a vertex to the face on the other side of that edge, and that face became a 5-sided n-gon. You trade the hole's n-gon for a small one next to it.",[11,1010,1012],{"id":1011},"method-4-bridge-edge-loops","Method 4: Bridge Edge Loops",[16,1014,1015,1016,1019],{},"If the \"hole\" is really a gap between two openings, such as the two ends of a tube, use ",[30,1017,1018],{},"Edge > Bridge Edge Loops"," instead of filling each hole separately.",[462,1021,1022,1025,1029],{},[38,1023,1024],{},"Select both edge loops.",[38,1026,307,1027,87],{},[30,1028,1018],{},[38,1030,1031,1032,1035],{},"In Adjust Last Operation, raise ",[30,1033,1034],{},"Number of Cuts"," for more rows.",[16,1037,1038],{},"With two 12-edge loops the result was 12 quads and nothing else. Setting Number of Cuts to 2 gave 36 quads, which is three rows of 12. When the two loops had different edge counts (12 and 8 in my test), Blender still bridged them but added 20 triangles to absorb the difference, so keep the counts equal where you can.",[11,1040,1042],{"id":1041},"method-5-poke-and-inset-on-an-n-gon","Method 5: Poke and Inset on an n-gon",[16,1044,1045,1046,87],{},"These are not fills, they are things you do after pressing ",[332,1047,532],{},[35,1049,1050,1059],{},[38,1051,1052,572,1055,1058],{},[30,1053,1054],{},"Face > Poke Faces",[332,1056,1057],{},"Alt+P",") turns the new n-gon into a fan of triangles around a new center vertex. A 16-sided cap became 16 triangles.",[38,1060,1061,572,1064,1067],{},[30,1062,1063],{},"Face > Inset Faces",[332,1065,1066],{},"I",") keeps the n-gon but adds a ring of quads around it. In my test the ring was 16 quads, and the inner 16-sided face was still there.",[16,1069,1070,1071,1074,1075,1078],{},"Neither gives a quad-only fill on its own. To get an all-quad cap, Inset the n-gon, delete the inner face (",[332,1072,1073],{},"X"," > ",[30,1076,1077],{},"Only Faces",") and Grid Fill the inner loop. The ring of quads gives the grid a cleaner edge flow. In my test on a 16-sided cylinder cap this gave 16 quads in the ring and 16 in the grid, with no triangles and no n-gon left on that cap. A 12-sided cap gave 12 plus 9 quads, with the same result in 4.2.23 and 5.2.2. A 15-sided cap failed with the usual Grid Fill message, so the inner loop still has to be even.",[11,1080,1082],{"id":1081},"which-method-to-use","Which method to use",[614,1084,1085,1101],{},[617,1086,1087],{},[620,1088,1089,1092,1095,1098],{},[623,1090,1091],{},"Method",[623,1093,1094],{},"Needs",[623,1096,1097],{},"Result in my test",[623,1099,1100],{},"Typical problem",[636,1102,1103,1118,1134,1147,1161,1175,1191],{},[620,1104,1105,1109,1112,1115],{},[641,1106,1107],{},[332,1108,532],{},[641,1110,1111],{},"Any closed loop",[641,1113,1114],{},"One n-gon with as many sides as the loop",[641,1116,1117],{},"Bad shading, breaks subdivision",[620,1119,1120,1126,1128,1131],{},[641,1121,1122,1123,1125],{},"Face > Fill (",[332,1124,931],{},")",[641,1127,1111],{},[641,1129,1130],{},"Edge count minus two triangles",[641,1132,1133],{},"No quads at all",[620,1135,1136,1138,1141,1144],{},[641,1137,960],{},[641,1139,1140],{},"Even number of edges",[641,1142,1143],{},"Quads only",[641,1145,1146],{},"Fails on odd loops with a confusing message",[620,1148,1149,1152,1155,1158],{},[641,1150,1151],{},"Subdivide, then Grid Fill",[641,1153,1154],{},"Odd loop",[641,1156,1157],{},"Quads plus one 5-sided face next to the hole",[641,1159,1160],{},"A new n-gon next to the patch",[620,1162,1163,1166,1169,1172],{},[641,1164,1165],{},"Bridge Edge Loops",[641,1167,1168],{},"Two loops",[641,1170,1171],{},"Quads when counts match",[641,1173,1174],{},"Triangles when counts differ",[620,1176,1177,1182,1185,1188],{},[641,1178,1179,1180],{},"Poke \u002F Inset after ",[332,1181,532],{},[641,1183,1184],{},"A filled n-gon",[641,1186,1187],{},"Triangle fan, or quad ring with an inner n-gon",[641,1189,1190],{},"Not a quad fill",[620,1192,1193,1196,1199,1202],{},[641,1194,1195],{},"Inset, delete inner face, Grid Fill",[641,1197,1198],{},"An even-sided n-gon cap",[641,1200,1201],{},"Quad ring plus quad grid",[641,1203,1204],{},"Fails when the inner loop is odd",[11,1206,712],{"id":711},[35,1208,1209,1215,1224,1232],{},[38,1210,1211,1214],{},[30,1212,1213],{},"Grid Fill does nothing and shows a message."," The loop is odd, or the selection is not one closed loop. Check the edge count in the statistics overlay.",[38,1216,1217,1220,1221,218],{},[30,1218,1219],{},"The patch does not follow the surface."," Look at the result from the side. If it sits flat or bulges, move vertices by hand, for example with Proportional Editing (",[332,1222,1223],{},"O",[38,1225,1226,1229,1230,87],{},[30,1227,1228],{},"Your mesh is all triangles"," (a scan, an STL). Quads will sit next to triangles however you fill the hole, so decide first whether you want to convert the whole thing, see ",[78,1231,583],{"href":159},[38,1233,1234,1237,1238,87],{},[30,1235,1236],{},"Every edge of the mesh counts as open."," That means the vertices are not welded, which happens with some imported files, and there is no real hole to fill yet. ",[78,1239,1240],{"href":166},"Clean up the mesh first",[11,1242,747],{"id":746},[16,1244,1245,1247,1248,1250],{},[78,1246,32],{"href":260}," is a Blender add-on with a ",[30,1249,42],{}," button. It does the selection, the parity problem and the grid in one click, and it works on several holes at once.",[462,1252,1253,1262,1269],{},[38,1254,350,1255,1257,1258,765,1260,218],{},[332,1256,334],{}," for Edit Mode and open the ",[30,1259,32],{},[332,1261,768],{},[38,1263,1264,1265,1268],{},"Select the hole, or select the whole mesh if you want every hole filled. With ",[30,1266,1267],{},"Only Selected"," on (the default), only loops that are fully selected are filled.",[38,1270,350,1271,87],{},[30,1272,42],{},[16,1274,1275],{},"What it does that Grid Fill does not, as I tested it in Blender 4.2.23 and 5.2.2:",[35,1277,1278,1284,1290,1296],{},[38,1279,1280,1283],{},[30,1281,1282],{},"Odd loops are filled."," The 15-edge hole that Grid Fill refused was closed in one click. The result was quads plus a single 5-sided face, the same kind of leftover as the manual subdivide trick.",[38,1285,1286,1289],{},[30,1287,1288],{},"Several holes at once."," A mesh with two 12-edge holes was filled in one press, with no triangles or n-gons added. With only one loop selected, only that loop was filled.",[38,1291,1292,1295],{},[30,1293,1294],{},"The panel reports what happened",", for example how many loops were filled and how many quads, triangles and n-gons the mesh has now.",[38,1297,1298,1301,1302,1304],{},[30,1299,1300],{},"The result depends on your mesh."," If the surrounding mesh is triangles, QuadFix keeps the patch triangular by default (",[30,1303,803],{},"). Turn that option off if you want quads next to triangles.",[16,1306,1307,1308,1310,1311,1314],{},"QuadFix repairs the mesh you have. It does not rebuild edge flow like a retopology tool, and on very irregular scans some leftover triangles are unavoidable. The full list of buttons and options is on the ",[78,1309,81],{"href":80},", and ",[78,1312,1313],{"href":85},"workflows"," shows it on typical repairs. The free QuadFix Lite covers n-gon and cleanup operations but not hole filling.",[11,1316,814],{"id":813},[35,1318,1319,1323],{},[38,1320,1321],{},[78,1322,825],{"href":159},[38,1324,1325],{},[78,1326,1327],{"href":166},"How to clean up an imported STL or OBJ mesh in Blender",{"title":237,"searchDepth":238,"depth":238,"links":1329},[1330,1331,1332,1333,1334,1338,1339,1340,1341,1342,1343],{"id":861,"depth":238,"text":862},{"id":875,"depth":238,"text":876},{"id":911,"depth":238,"text":912},{"id":921,"depth":238,"text":922},{"id":942,"depth":238,"text":943,"children":1335},[1336],{"id":1000,"depth":1337,"text":1001},3,{"id":1011,"depth":238,"text":1012},{"id":1041,"depth":238,"text":1042},{"id":1081,"depth":238,"text":1082},{"id":711,"depth":238,"text":712},{"id":746,"depth":238,"text":747},{"id":813,"depth":238,"text":814},"Fill a hole in a Blender mesh with quads, not an n-gon or a triangle fan. Grid Fill, Bridge Edge Loops and the other options, and when each one fails.",{},"---\ntitle: How to fill a hole with quads in Blender\ndescription: Fill a hole in a Blender mesh with quads, not an n-gon or a triangle fan. Grid Fill, Bridge Edge Loops and the other options, and when each one fails.\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo fill a hole with quads in Blender, select the edge loop around the hole and use **Face > Grid Fill**. It builds a quad grid across the opening, but only when the loop has an even number of edges. For a hole with an odd edge count, an irregular outline or a gap between two loops, you need one of the workarounds below, or a tool that does it in one click.\n\nThis guide covers each built-in method, what it produces and where it breaks. I tested every result in Blender 4.2.23 and 5.2.2 on a UV sphere with faces deleted. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.\n\n## Why the default fill is usually not what you want\n\nPressing `F` on a closed edge loop is the obvious first move, and it works, but it creates **one n-gon** with as many sides as the loop has edges. In my test, a 12-edge hole became a single 12-sided face, and a 15-edge hole became a single 15-sided face. That is fine for a flat cap, but it shades badly on a curved surface and it is the face type you were probably trying to get rid of.\n\n## Step 1: select the edges around the hole\n\n1. Press `Tab` to enter Edit Mode and press `2` for edge select mode.\n2. Click one edge of the hole.\n3. Choose **Select > Select Loops > Edge Loops**. In my test this selected the whole boundary of that one hole and nothing else, even with a second hole on the mesh. (The menu entry is the same in 4.2 and 5.x.)\n4. Turn on **Overlays > Statistics** and read the selected edge count. You need to know whether it is even or odd.\n\nIf the mesh has only the one hole, you can instead use **Select > Select All by Trait > Non Manifold** (available in vertex and edge select mode, not in face mode) and keep only **Boundaries** ticked in the Adjust Last Operation panel. That selects every open border on the mesh, so with several holes it selects them all.\n\n## Method 1: F (New Edge\u002FFace from Vertices)\n\nWith the loop selected, press `F`. The hole is closed by a single n-gon. It cannot fail, and it improves nothing. Use it only when a flat n-gon is acceptable.\n\n## Method 2: Face > Fill (Alt+F)\n\nWith the loop selected, choose **Face > Fill** or press `Alt+F`. Blender triangulates the hole. In my test a 12-edge loop gave 10 triangles, a 15-edge loop gave 13 and a 16-edge loop gave 14: the edge count minus two. There are no n-gons, but there are no quads either. Running **Face > Tris to Quads** (**Triangles to Quads** in 5.x, `Alt+J`) on the result joined only a few pairs of triangles in the 16-edge test, so it is not a way to a clean grid.\n\n## Method 3: Grid Fill (Ctrl+F > Grid Fill)\n\nThis is the method that gives quads.\n\n1. Select the loop as above.\n2. Press `Ctrl+F` to open the Face menu and choose **Grid Fill**, or use the Face menu in the header.\n3. Open the **Adjust Last Operation** panel in the bottom-left corner of the viewport.\n4. Change **Span** and **Offset** until the grid looks straight.\n\n**Even loops work.** In my test, 12-edge and 16-edge holes were filled with quads only, with no triangles or n-gons created, and the hole's boundary was closed. **Span** controls how many rows of quads cross the hole (the result changed from 5 to 9 new faces on the 12-edge loop as Span went from 1 to 3, all of them quads). **Offset** rotates where the grid starts on the loop, which helps when the result looks twisted. On the first run Blender chooses the Span itself.\n\n**Odd loops fail.** On a 15-edge loop nothing happened. Blender only showed the message \"Select two edge loops or a single closed edge loop from which two edge loops can be calculated\". That message does not mention the real cause, which is that a single loop has to be split into two halves of equal length.\n\n### Making an odd loop even\n\nAdd or remove one vertex on the loop. In my test, selecting one edge of the 15-edge loop and subdividing it (**Edge > Subdivide**) made the loop 16 edges long, and Grid Fill then produced quads. The catch is that subdividing a border edge also adds a vertex to the face on the other side of that edge, and that face became a 5-sided n-gon. You trade the hole's n-gon for a small one next to it.\n\n## Method 4: Bridge Edge Loops\n\nIf the \"hole\" is really a gap between two openings, such as the two ends of a tube, use **Edge > Bridge Edge Loops** instead of filling each hole separately.\n\n1. Select both edge loops.\n2. Choose **Edge > Bridge Edge Loops**.\n3. In Adjust Last Operation, raise **Number of Cuts** for more rows.\n\nWith two 12-edge loops the result was 12 quads and nothing else. Setting Number of Cuts to 2 gave 36 quads, which is three rows of 12. When the two loops had different edge counts (12 and 8 in my test), Blender still bridged them but added 20 triangles to absorb the difference, so keep the counts equal where you can.\n\n## Method 5: Poke and Inset on an n-gon\n\nThese are not fills, they are things you do after pressing `F`.\n\n- **Face > Poke Faces** (`Alt+P`) turns the new n-gon into a fan of triangles around a new center vertex. A 16-sided cap became 16 triangles.\n- **Face > Inset Faces** (`I`) keeps the n-gon but adds a ring of quads around it. In my test the ring was 16 quads, and the inner 16-sided face was still there.\n\nNeither gives a quad-only fill on its own. To get an all-quad cap, Inset the n-gon, delete the inner face (`X` > **Only Faces**) and Grid Fill the inner loop. The ring of quads gives the grid a cleaner edge flow. In my test on a 16-sided cylinder cap this gave 16 quads in the ring and 16 in the grid, with no triangles and no n-gon left on that cap. A 12-sided cap gave 12 plus 9 quads, with the same result in 4.2.23 and 5.2.2. A 15-sided cap failed with the usual Grid Fill message, so the inner loop still has to be even.\n\n## Which method to use\n\n| Method | Needs | Result in my test | Typical problem |\n| --- | --- | --- | --- |\n| `F` | Any closed loop | One n-gon with as many sides as the loop | Bad shading, breaks subdivision |\n| Face > Fill (`Alt+F`) | Any closed loop | Edge count minus two triangles | No quads at all |\n| Grid Fill | Even number of edges | Quads only | Fails on odd loops with a confusing message |\n| Subdivide, then Grid Fill | Odd loop | Quads plus one 5-sided face next to the hole | A new n-gon next to the patch |\n| Bridge Edge Loops | Two loops | Quads when counts match | Triangles when counts differ |\n| Poke \u002F Inset after `F` | A filled n-gon | Triangle fan, or quad ring with an inner n-gon | Not a quad fill |\n| Inset, delete inner face, Grid Fill | An even-sided n-gon cap | Quad ring plus quad grid | Fails when the inner loop is odd |\n\n## What can go wrong\n\n- **Grid Fill does nothing and shows a message.** The loop is odd, or the selection is not one closed loop. Check the edge count in the statistics overlay.\n- **The patch does not follow the surface.** Look at the result from the side. If it sits flat or bulges, move vertices by hand, for example with Proportional Editing (`O`).\n- **Your mesh is all triangles** (a scan, an STL). Quads will sit next to triangles however you fill the hole, so decide first whether you want to convert the whole thing, see [turning n-gons and triangles into quads](\u002Fguides\u002Fngons-to-quads).\n- **Every edge of the mesh counts as open.** That means the vertices are not welded, which happens with some imported files, and there is no real hole to fill yet. [Clean up the mesh first](\u002Fguides\u002Fclean-up-imported-stl).\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) is a Blender add-on with a **Fill Holes with Quads** button. It does the selection, the parity problem and the grid in one click, and it works on several holes at once.\n\n1. Press `Tab` for Edit Mode and open the **QuadFix** tab in the sidebar (`N`).\n2. Select the hole, or select the whole mesh if you want every hole filled. With **Only Selected** on (the default), only loops that are fully selected are filled.\n3. Press **Fill Holes with Quads**.\n\nWhat it does that Grid Fill does not, as I tested it in Blender 4.2.23 and 5.2.2:\n\n- **Odd loops are filled.** The 15-edge hole that Grid Fill refused was closed in one click. The result was quads plus a single 5-sided face, the same kind of leftover as the manual subdivide trick.\n- **Several holes at once.** A mesh with two 12-edge holes was filled in one press, with no triangles or n-gons added. With only one loop selected, only that loop was filled.\n- **The panel reports what happened**, for example how many loops were filled and how many quads, triangles and n-gons the mesh has now.\n- **The result depends on your mesh.** If the surrounding mesh is triangles, QuadFix keeps the patch triangular by default (**Match Triangle Meshes**). Turn that option off if you want quads next to triangles.\n\nQuadFix repairs the mesh you have. It does not rebuild edge flow like a retopology tool, and on very irregular scans some leftover triangles are unavoidable. The full list of buttons and options is on the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel), and [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows) shows it on typical repairs. The free QuadFix Lite covers n-gon and cleanup operations but not hole filling.\n\n## Related guides\n\n- [How to turn n-gons and triangles into quads in Blender](\u002Fguides\u002Fngons-to-quads)\n- [How to clean up an imported STL or OBJ mesh in Blender](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":549,"description":1344},"guides\u002Ffill-hole-with-quads","ubODEO0xa21pFfQSpyev8gnKv3TQZDg1RpFC5HKU9sQ",{"id":1351,"title":1352,"addon":276,"body":1353,"description":1939,"extension":255,"meta":1940,"navigation":259,"path":159,"poster":261,"rawbody":1941,"seo":1942,"stem":1943,"updated":268,"video":270,"__hash__":1944},"guides\u002Fguides\u002Fngons-to-quads.md","Convert n-gons and tris to quads in Blender",{"type":8,"value":1354,"toc":1924},[1355,1378,1388,1392,1428,1439,1443,1460,1463,1467,1516,1519,1580,1591,1595,1598,1618,1621,1629,1633,1636,1661,1668,1672,1685,1689,1696,1700,1719,1730,1732,1818,1820,1843,1845,1852,1874,1877,1903,1912,1914],[16,1356,1357,1358,572,1361,1364,1365,1074,1367,1369,1370,1372,1373,572,1375,1377],{},"To turn an n-gon into quads in Blender, cut it with ",[30,1359,1360],{},"Connect Vertex Path",[332,1362,1363],{},"J",") between two vertices three steps apart, or delete the face (",[332,1366,1073],{},[30,1368,1077],{},") and refill the opening with ",[30,1371,538],{},". Both need an even number of sides. For triangles, select them and press ",[332,1374,579],{},[30,1376,571],{},"), which joins neighbouring pairs but ignores n-gons. No built-in tool does both in one go.",[16,1379,1380,1381,1383,1384,1387],{},"I tested every result below in Blender 4.2.23 and 5.2.2 on small test meshes, so the numbers are from real runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys. In Blender 5.x the menu entry is called ",[30,1382,575],{},", in 4.2 it is ",[30,1385,1386],{},"Tris to Quads",". It is the same operator with the same shortcut.",[11,1389,1391],{"id":1390},"step-1-find-the-faces-that-are-not-quads","Step 1: find the faces that are not quads",[462,1393,1394,1403,1408,1423],{},[38,1395,350,1396,1398,1399,1402],{},[332,1397,334],{}," for Edit Mode and press ",[332,1400,1401],{},"3"," for face select mode.",[38,1404,307,1405,87],{},[30,1406,1407],{},"Select > Select All by Trait > Faces by Sides",[38,1409,1410,1411,1414,1415,1418,1419,1422],{},"In the Adjust Last Operation panel set ",[30,1412,1413],{},"Number of Vertices"," to 4 and ",[30,1416,1417],{},"Type"," to ",[30,1420,1421],{},"Not Equal To",". This selects every triangle and every n-gon.",[38,1424,896,1425,1427],{},[30,1426,342],{}," to see how many faces are selected.",[16,1429,1430,1431,1434,1435,1438],{},"On a test grid with one 12-sided n-gon and 16 triangles, Not Equal To selected 17 faces. Type ",[30,1432,1433],{},"Greater Than"," with 4 selected only the n-gon, and ",[30,1436,1437],{},"Less Than"," with 4 selected only the 16 triangles. Use those two to treat triangles and n-gons separately, because they need different tools.",[11,1440,1442],{"id":1441},"step-2-triangles-to-quads-with-altj","Step 2: triangles to quads with Alt+J",[462,1444,1445,1448,1455],{},[38,1446,1447],{},"Select the triangles (or the whole mesh) in Edit Mode.",[38,1449,350,1450,1452,1453,87],{},[332,1451,579],{},", or choose ",[30,1454,571],{},[38,1456,428,1457,1459],{},[30,1458,967],{}," and tune the options.",[16,1461,1462],{},"When a triangulated quad is simply sitting there, it rejoins cleanly. In my test grid the 16 triangles became 8 quads and none were left. The 12-sided n-gon was left untouched, because this operator only looks at triangles.",[998,1464,1466],{"id":1465},"the-options-that-matter","The options that matter",[614,1468,1469,1482],{},[617,1470,1471],{},[620,1472,1473,1476,1479],{},[623,1474,1475],{},"Option",[623,1477,1478],{},"Default",[623,1480,1481],{},"What it does",[636,1483,1484,1495,1505],{},[620,1485,1486,1489,1492],{},[641,1487,1488],{},"Max Face Angle",[641,1490,1491],{},"40 degrees",[641,1493,1494],{},"How different the two triangle normals may be",[620,1496,1497,1500,1502],{},[641,1498,1499],{},"Max Shape Angle",[641,1501,1491],{},[641,1503,1504],{},"How far the joined quad may be from a rectangle",[620,1506,1507,1510,1513],{},[641,1508,1509],{},"Compare UVs, Color Attributes, Seam, Sharp, Materials",[641,1511,1512],{},"off",[641,1514,1515],{},"When on, triangles are not joined across a UV border, seam, sharp edge or material boundary",[16,1517,1518],{},"The two angle values decide how many triangles survive. On a triangulated UV sphere with its vertices randomly nudged (528 triangles to start), Blender 5.2.2 gave:",[614,1520,1521,1534],{},[617,1522,1523],{},[620,1524,1525,1528,1531],{},[623,1526,1527],{},"Both angles",[623,1529,1530],{},"Triangles left",[623,1532,1533],{},"Quads",[636,1535,1536,1547,1558,1569],{},[620,1537,1538,1541,1544],{},[641,1539,1540],{},"10 degrees",[641,1542,1543],{},"512",[641,1545,1546],{},"8",[620,1548,1549,1552,1555],{},[641,1550,1551],{},"40 degrees (default)",[641,1553,1554],{},"182",[641,1556,1557],{},"173",[620,1559,1560,1563,1566],{},[641,1561,1562],{},"90 degrees",[641,1564,1565],{},"42",[641,1567,1568],{},"243",[620,1570,1571,1574,1577],{},[641,1572,1573],{},"180 degrees",[641,1575,1576],{},"28",[641,1578,1579],{},"250",[16,1581,1582,1583,1586,1587,1590],{},"Blender 4.2.23 gave slightly different counts on the same mesh but the same trend. Higher angles join more pairs, and the quads get less regular. The Compare options work as blockers: with every edge marked as a seam and ",[30,1584,1585],{},"Compare Seam"," on, no triangle was joined at all, and the same happened with every edge sharp and ",[30,1588,1589],{},"Compare Sharp"," on. If Alt+J does nothing on your mesh, look for a Compare option left on, or for edges marked as seams or sharp.",[11,1592,1594],{"id":1593},"step-3-split-an-n-gon-with-connect-vertex-path-j","Step 3: split an n-gon with Connect Vertex Path (J)",[16,1596,1597],{},"An n-gon can only be cut into quads if its number of sides is even: an n-gon with n sides makes (n minus 2) divided by 2 quads. So an 8-gon gives 3 quads and a 6-gon gives 2. An n-gon with an odd number of sides cannot be cut into only quads unless you add a vertex.",[462,1599,1600,1605,1608,1615],{},[38,1601,350,1602,1604],{},[332,1603,468],{}," for vertex select mode.",[38,1606,1607],{},"Click one vertex of the n-gon, then click the vertex three steps further along its outline, so the cut separates a piece with four corners.",[38,1609,307,1610,432,1613,87],{},[30,1611,1612],{},"Vertex > Connect Vertex Path",[332,1614,1363],{},[38,1616,1617],{},"Repeat on the remaining n-gon until only quads are left.",[16,1619,1620],{},"Blender uses the order in which you selected the vertices, so click them one after the other instead of box-selecting. In my test an 8-sided n-gon was cut once, which gave a quad and a 6-sided n-gon. Cutting the 6-gon once more gave two quads. Three quads in total, no triangles.",[1622,1623,1624],"blockquote",{},[16,1625,1626,1627,87],{},"A cut in the wrong place leaves two smaller n-gons instead of quads. Count the steps between your two picks before pressing ",[332,1628,1363],{},[11,1630,1632],{"id":1631},"step-4-delete-the-n-gon-and-grid-fill-it","Step 4: delete the n-gon and Grid Fill it",[16,1634,1635],{},"For a large n-gon with an even number of sides, a grid usually looks better than a few straight cuts.",[462,1637,1638,1641,1649,1654],{},[38,1639,1640],{},"Select the n-gon face.",[38,1642,350,1643,1645,1646,1648],{},[332,1644,1073],{}," and choose ",[30,1647,1077],{},". This removes the face and keeps its edges.",[38,1650,1651,1652,87],{},"Select one edge of the opening and choose ",[30,1653,545],{},[38,1655,307,1656,572,1658,1660],{},[30,1657,538],{},[332,1659,956],{},", then Grid Fill).",[16,1662,1663,1664,1667],{},"Two 8-sided n-gons (a 2 by 2 block and an L shape of three quads) were filled this way and both came out as quads only, four new quads each. As with any hole, an odd number of edges fails with a Grid Fill message and nothing changes. ",[78,1665,1666],{"href":152},"The hole-filling guide"," explains the odd-loop workaround.",[11,1669,1671],{"id":1670},"step-5-triangulate-first-then-altj-only-for-small-n-gons","Step 5: triangulate first, then Alt+J, only for small n-gons",[16,1673,1674,1675,319,1678,1681,1682,1684],{},"Triangulating an n-gon (",[30,1676,1677],{},"Face > Triangulate Faces",[332,1679,1680],{},"Ctrl+T",") and then pressing ",[332,1683,579],{}," is the lazy route. In my test the 12-sided n-gon became 10 triangles, and Alt+J turned only two pairs into quads, leaving 6 triangles. It is acceptable for a tiny n-gon in a place nobody sees, not a way to clean up topology.",[11,1686,1688],{"id":1687},"when-n-gons-are-fine","When n-gons are fine",[16,1690,1691,1692,1695],{},"N-gons are not an error. A flat n-gon on a hard-surface model that will not be deformed or subdivided shades correctly and can stay as it is. Convert them where they sit on a curved surface, where the mesh will be animated or subdivided, or where they cause shading problems. QuadFix's ",[30,1693,1694],{},"Keep Planar N-gons"," option works on the same idea.",[11,1697,1699],{"id":1698},"why-not-remesh-everything","Why not remesh everything?",[16,1701,1702,1703,1706,1707,1710,1711,1714,1715,1718],{},"Blender can rebuild a mesh as quads for you: select the object, open the ",[30,1704,1705],{},"Object Data"," properties tab, open the ",[30,1708,1709],{},"Remesh"," panel, set ",[30,1712,1713],{},"Mode"," to Quad and press ",[30,1716,1717],{},"QuadriFlow Remesh",". Tested on a UV sphere (240 quads, 48 triangles at the poles), it returned only quads. The catches:",[35,1720,1721,1724,1727],{},[38,1722,1723],{},"It ignores your topology. The face count follows the target you set, not the mesh you had. A target of 500 faces gave 598 in my test.",[38,1725,1726],{},"Your loops, UV layout and vertex positions are gone, because it is a new mesh.",[38,1728,1729],{},"It does not close holes. A sphere with a hole stayed open after the remesh.",[11,1731,1082],{"id":1081},[614,1733,1734,1746],{},[617,1735,1736],{},[620,1737,1738,1741,1743],{},[623,1739,1740],{},"Situation",[623,1742,1091],{},[623,1744,1745],{},"What you get",[636,1747,1748,1760,1773,1786,1797,1808],{},[620,1749,1750,1753,1757],{},[641,1751,1752],{},"Triangles that came from triangulating quads",[641,1754,1755],{},[332,1756,579],{},[641,1758,1759],{},"Mostly clean quads",[620,1761,1762,1765,1770],{},[641,1763,1764],{},"Triangles on a noisy or scanned surface",[641,1766,1767,1769],{},[332,1768,579],{}," with larger angles",[641,1771,1772],{},"More quads, less regular shapes",[620,1774,1775,1778,1783],{},[641,1776,1777],{},"One n-gon with an even number of sides",[641,1779,1780,1782],{},[332,1781,1363],{}," repeatedly",[641,1784,1785],{},"(n minus 2) divided by 2 quads",[620,1787,1788,1791,1794],{},[641,1789,1790],{},"A big even n-gon",[641,1792,1793],{},"Delete face, then Grid Fill",[641,1795,1796],{},"A grid of quads",[620,1798,1799,1802,1805],{},[641,1800,1801],{},"An odd n-gon",[641,1803,1804],{},"Add a vertex, then cut or Grid Fill",[641,1806,1807],{},"A leftover n-gon next to the patch",[620,1809,1810,1813,1815],{},[641,1811,1812],{},"A whole model to rebuild",[641,1814,1717],{},[641,1816,1817],{},"All quads, new topology",[11,1819,712],{"id":711},[35,1821,1822,1828,1834],{},[38,1823,1824,1827],{},[30,1825,1826],{},"Alt+J joins nothing."," Check the Compare options and any seam or sharp marks, or raise the angles.",[38,1829,1830,1833],{},[30,1831,1832],{},"The result is skewed or wavy."," The angles are too large. Go back to 40 degrees and accept a few triangles.",[38,1835,1836,1839,1840,87],{},[30,1837,1838],{},"Selection looks right but nothing happens."," The mesh may have unwelded vertices, so neighbouring faces are not really connected. See ",[78,1841,1842],{"href":166},"cleaning up an imported mesh",[11,1844,747],{"id":746},[16,1846,1847,1849,1850,87],{},[78,1848,32],{"href":260}," puts triangles and n-gons into one button, ",[30,1851,54],{},[462,1853,1854,1861,1866,1871],{},[38,1855,1856,1857,765,1859,218],{},"In Edit Mode open the ",[30,1858,32],{},[332,1860,768],{},[38,1862,350,1863,1865],{},[30,1864,66],{}," to see what is wrong. The panel prints the number of non-quad faces and boundary edges.",[38,1867,1868,1869,87],{},"Select the area or the whole mesh and press ",[30,1870,54],{},[38,1872,1873],{},"Read the report line: it shows n-gons, triangles and quads before and after.",[16,1875,1876],{},"What my tests showed on Blender 4.2.23 and 5.2.2:",[35,1878,1879,1885,1893],{},[38,1880,1881,1884],{},[30,1882,1883],{},"Curved n-gons are converted along with triangles."," A curved 8-sided n-gon on a bowl-shaped surface was replaced with four quads and the report showed n-gons going from 1 to 0.",[38,1886,1887,572,1890,1892],{},[30,1888,1889],{},"Flat n-gons are left alone by default",[30,1891,1694],{},"), so clean CAD faces are not touched. On a flat 8-gon the button reported there was nothing to convert. Turn the option off and the same n-gon was converted to quads.",[38,1894,1895,1898,1899,1902],{},[30,1896,1897],{},"The default angles are 90 degrees."," On the nudged sphere above, the defaults left 42 triangles in 5.2.2 (52 in 4.2.23, again the same as Alt+J at 90). ",[30,1900,1901],{},"Aggressive Quads"," brought it to 28, the same as Alt+J at 180. So the angle settings are not magic, the gain is having n-gons, triangles and the report in a single step.",[16,1904,1905,1906,1908,1909,1911],{},"QuadFix repairs the mesh you have and is not a retopology tool: some leftover triangles on irregular scans are unavoidable, and it shows them instead of hiding them. All options are in the ",[78,1907,81],{"href":80},", and the ",[78,1910,86],{"href":85}," walks through typical repairs. The free QuadFix Lite includes N-gons to Quads and the cleanup button.",[11,1913,814],{"id":813},[35,1915,1916,1920],{},[38,1917,1918],{},[78,1919,549],{"href":152},[38,1921,1922],{},[78,1923,1327],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":1925},[1926,1927,1930,1931,1932,1933,1934,1935,1936,1937,1938],{"id":1390,"depth":238,"text":1391},{"id":1441,"depth":238,"text":1442,"children":1928},[1929],{"id":1465,"depth":1337,"text":1466},{"id":1593,"depth":238,"text":1594},{"id":1631,"depth":238,"text":1632},{"id":1670,"depth":238,"text":1671},{"id":1687,"depth":238,"text":1688},{"id":1698,"depth":238,"text":1699},{"id":1081,"depth":238,"text":1082},{"id":711,"depth":238,"text":712},{"id":746,"depth":238,"text":747},{"id":813,"depth":238,"text":814},"Convert n-gons and triangles to quads in Blender with Faces by Sides, Tris to Quads (Alt+J), Connect Vertex Path and Grid Fill, and learn where each one stops.",{},"---\ntitle: \"Convert n-gons and tris to quads in Blender\"\ndescription: \"Convert n-gons and triangles to quads in Blender with Faces by Sides, Tris to Quads (Alt+J), Connect Vertex Path and Grid Fill, and learn where each one stops.\"\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo turn an n-gon into quads in Blender, cut it with **Connect Vertex Path** (`J`) between two vertices three steps apart, or delete the face (`X` > **Only Faces**) and refill the opening with **Face > Grid Fill**. Both need an even number of sides. For triangles, select them and press `Alt+J` (**Face > Tris to Quads**), which joins neighbouring pairs but ignores n-gons. No built-in tool does both in one go.\n\nI tested every result below in Blender 4.2.23 and 5.2.2 on small test meshes, so the numbers are from real runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys. In Blender 5.x the menu entry is called **Triangles to Quads**, in 4.2 it is **Tris to Quads**. It is the same operator with the same shortcut.\n\n## Step 1: find the faces that are not quads\n\n1. Press `Tab` for Edit Mode and press `3` for face select mode.\n2. Choose **Select > Select All by Trait > Faces by Sides**.\n3. In the Adjust Last Operation panel set **Number of Vertices** to 4 and **Type** to **Not Equal To**. This selects every triangle and every n-gon.\n4. Turn on **Overlays > Statistics** to see how many faces are selected.\n\nOn a test grid with one 12-sided n-gon and 16 triangles, Not Equal To selected 17 faces. Type **Greater Than** with 4 selected only the n-gon, and **Less Than** with 4 selected only the 16 triangles. Use those two to treat triangles and n-gons separately, because they need different tools.\n\n## Step 2: triangles to quads with Alt+J\n\n1. Select the triangles (or the whole mesh) in Edit Mode.\n2. Press `Alt+J`, or choose **Face > Tris to Quads**.\n3. Open **Adjust Last Operation** and tune the options.\n\nWhen a triangulated quad is simply sitting there, it rejoins cleanly. In my test grid the 16 triangles became 8 quads and none were left. The 12-sided n-gon was left untouched, because this operator only looks at triangles.\n\n### The options that matter\n\n| Option | Default | What it does |\n| --- | --- | --- |\n| Max Face Angle | 40 degrees | How different the two triangle normals may be |\n| Max Shape Angle | 40 degrees | How far the joined quad may be from a rectangle |\n| Compare UVs, Color Attributes, Seam, Sharp, Materials | off | When on, triangles are not joined across a UV border, seam, sharp edge or material boundary |\n\nThe two angle values decide how many triangles survive. On a triangulated UV sphere with its vertices randomly nudged (528 triangles to start), Blender 5.2.2 gave:\n\n| Both angles | Triangles left | Quads |\n| --- | --- | --- |\n| 10 degrees | 512 | 8 |\n| 40 degrees (default) | 182 | 173 |\n| 90 degrees | 42 | 243 |\n| 180 degrees | 28 | 250 |\n\nBlender 4.2.23 gave slightly different counts on the same mesh but the same trend. Higher angles join more pairs, and the quads get less regular. The Compare options work as blockers: with every edge marked as a seam and **Compare Seam** on, no triangle was joined at all, and the same happened with every edge sharp and **Compare Sharp** on. If Alt+J does nothing on your mesh, look for a Compare option left on, or for edges marked as seams or sharp.\n\n## Step 3: split an n-gon with Connect Vertex Path (J)\n\nAn n-gon can only be cut into quads if its number of sides is even: an n-gon with n sides makes (n minus 2) divided by 2 quads. So an 8-gon gives 3 quads and a 6-gon gives 2. An n-gon with an odd number of sides cannot be cut into only quads unless you add a vertex.\n\n1. Press `1` for vertex select mode.\n2. Click one vertex of the n-gon, then click the vertex three steps further along its outline, so the cut separates a piece with four corners.\n3. Choose **Vertex > Connect Vertex Path** or press `J`.\n4. Repeat on the remaining n-gon until only quads are left.\n\nBlender uses the order in which you selected the vertices, so click them one after the other instead of box-selecting. In my test an 8-sided n-gon was cut once, which gave a quad and a 6-sided n-gon. Cutting the 6-gon once more gave two quads. Three quads in total, no triangles.\n\n> A cut in the wrong place leaves two smaller n-gons instead of quads. Count the steps between your two picks before pressing `J`.\n\n## Step 4: delete the n-gon and Grid Fill it\n\nFor a large n-gon with an even number of sides, a grid usually looks better than a few straight cuts.\n\n1. Select the n-gon face.\n2. Press `X` and choose **Only Faces**. This removes the face and keeps its edges.\n3. Select one edge of the opening and choose **Select > Select Loops > Edge Loops**.\n4. Choose **Face > Grid Fill** (`Ctrl+F`, then Grid Fill).\n\nTwo 8-sided n-gons (a 2 by 2 block and an L shape of three quads) were filled this way and both came out as quads only, four new quads each. As with any hole, an odd number of edges fails with a Grid Fill message and nothing changes. [The hole-filling guide](\u002Fguides\u002Ffill-hole-with-quads) explains the odd-loop workaround.\n\n## Step 5: triangulate first, then Alt+J, only for small n-gons\n\nTriangulating an n-gon (**Face > Triangulate Faces**, `Ctrl+T`) and then pressing `Alt+J` is the lazy route. In my test the 12-sided n-gon became 10 triangles, and Alt+J turned only two pairs into quads, leaving 6 triangles. It is acceptable for a tiny n-gon in a place nobody sees, not a way to clean up topology.\n\n## When n-gons are fine\n\nN-gons are not an error. A flat n-gon on a hard-surface model that will not be deformed or subdivided shades correctly and can stay as it is. Convert them where they sit on a curved surface, where the mesh will be animated or subdivided, or where they cause shading problems. QuadFix's **Keep Planar N-gons** option works on the same idea.\n\n## Why not remesh everything?\n\nBlender can rebuild a mesh as quads for you: select the object, open the **Object Data** properties tab, open the **Remesh** panel, set **Mode** to Quad and press **QuadriFlow Remesh**. Tested on a UV sphere (240 quads, 48 triangles at the poles), it returned only quads. The catches:\n\n- It ignores your topology. The face count follows the target you set, not the mesh you had. A target of 500 faces gave 598 in my test.\n- Your loops, UV layout and vertex positions are gone, because it is a new mesh.\n- It does not close holes. A sphere with a hole stayed open after the remesh.\n\n## Which method to use\n\n| Situation | Method | What you get |\n| --- | --- | --- |\n| Triangles that came from triangulating quads | `Alt+J` | Mostly clean quads |\n| Triangles on a noisy or scanned surface | `Alt+J` with larger angles | More quads, less regular shapes |\n| One n-gon with an even number of sides | `J` repeatedly | (n minus 2) divided by 2 quads |\n| A big even n-gon | Delete face, then Grid Fill | A grid of quads |\n| An odd n-gon | Add a vertex, then cut or Grid Fill | A leftover n-gon next to the patch |\n| A whole model to rebuild | QuadriFlow Remesh | All quads, new topology |\n\n## What can go wrong\n\n- **Alt+J joins nothing.** Check the Compare options and any seam or sharp marks, or raise the angles.\n- **The result is skewed or wavy.** The angles are too large. Go back to 40 degrees and accept a few triangles.\n- **Selection looks right but nothing happens.** The mesh may have unwelded vertices, so neighbouring faces are not really connected. See [cleaning up an imported mesh](\u002Fguides\u002Fclean-up-imported-stl).\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) puts triangles and n-gons into one button, **N-gons to Quads**.\n\n1. In Edit Mode open the **QuadFix** tab in the sidebar (`N`).\n2. Press **Select Non-Quads & Holes** to see what is wrong. The panel prints the number of non-quad faces and boundary edges.\n3. Select the area or the whole mesh and press **N-gons to Quads**.\n4. Read the report line: it shows n-gons, triangles and quads before and after.\n\nWhat my tests showed on Blender 4.2.23 and 5.2.2:\n\n- **Curved n-gons are converted along with triangles.** A curved 8-sided n-gon on a bowl-shaped surface was replaced with four quads and the report showed n-gons going from 1 to 0.\n- **Flat n-gons are left alone by default** (**Keep Planar N-gons**), so clean CAD faces are not touched. On a flat 8-gon the button reported there was nothing to convert. Turn the option off and the same n-gon was converted to quads.\n- **The default angles are 90 degrees.** On the nudged sphere above, the defaults left 42 triangles in 5.2.2 (52 in 4.2.23, again the same as Alt+J at 90). **Aggressive Quads** brought it to 28, the same as Alt+J at 180. So the angle settings are not magic, the gain is having n-gons, triangles and the report in a single step.\n\nQuadFix repairs the mesh you have and is not a retopology tool: some leftover triangles on irregular scans are unavoidable, and it shows them instead of hiding them. All options are in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel), and the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows) walks through typical repairs. The free QuadFix Lite includes N-gons to Quads and the cleanup button.\n\n## Related guides\n\n- [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads)\n- [How to clean up an imported STL or OBJ mesh in Blender](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":1352,"description":1939},"guides\u002Fngons-to-quads","LqiKPhIwJM22DyYIZpSnJu8dZDYIfXpJ_e9Q9mIHvSE",[1946,2114,2370,2964,3304,3678],{"id":1947,"title":1948,"addon":276,"body":1949,"description":2107,"extension":255,"meta":2108,"navigation":259,"order":2109,"path":228,"rawbody":2110,"seo":2111,"stem":2112,"updated":268,"__hash__":2113},"docs\u002Fdocs\u002Fquadfix\u002Findex.md","QuadFix documentation",{"type":8,"value":1950,"toc":2099},[1951,1955,1961,1965,1997,2001,2039,2044,2046,2049,2063,2067,2072,2076],[11,1952,1954],{"id":1953},"what-quadfix-is","What QuadFix is",[16,1956,1957,1958,87],{},"QuadFix is a Blender add-on for repairing meshes with quads. It fills holes, bridges edge loops, converts triangles and n-gons, cleans up Boolean and imported meshes and unions objects with a clean seam. This documentation covers version 1.4.5 on Blender 4.2 and newer. For a short pitch and the price, see the ",[78,1959,1960],{"href":260},"QuadFix product page",[11,1962,1964],{"id":1963},"contents","Contents",[35,1966,1967,1973,1979,1985,1991],{},[38,1968,1969,1972],{},[78,1970,1971],{"href":139},"Install",": install from the .zip, find the panel, update, uninstall, and compare Lite with the full version.",[38,1974,1975,1978],{},[78,1976,1977],{"href":80},"Panel reference",": every panel, button and option with defaults and ranges.",[38,1980,1981,1984],{},[78,1982,1983],{"href":85},"Workflows",": step-by-step recipes for filling a hole, bridging two loops, cleaning after a Boolean, converting n-gons and joining objects.",[38,1986,1987,1990],{},[78,1988,1989],{"href":127},"Troubleshooting",": the messages you can see and how to fix each cause.",[38,1992,1993,1996],{},[78,1994,1995],{"href":233},"Changelog",": what changed in each version.",[11,1998,2000],{"id":1999},"the-idea-in-one-minute","The idea in one minute",[462,2002,2003,2012,2018,2023,2029],{},[38,2004,2005,2006,2008,2009,2011],{},"Open the 3D viewport sidebar with ",[332,2007,768],{}," and choose the ",[30,2010,32],{}," tab.",[38,2013,2014,2015,2017],{},"Select a mesh object and press ",[332,2016,334],{}," for Edit Mode.",[38,2019,350,2020,2022],{},[30,2021,66],{}," to see what is wrong. The counts appear at the bottom of the panel.",[38,2024,2025,2026,2028],{},"Select the part you want to fix, or press ",[332,2027,338],{}," for everything, and press the tool you need.",[38,2030,2031,2032,572,2035,2038],{},"Read the last-result line at the bottom of the panel. ",[332,2033,2034],{},"Ctrl+Z",[332,2036,2037],{},"Cmd+Z"," on Mac) undoes the step.",[16,2040,124,2041,2043],{},[30,2042,1267],{}," option is on by default, so a tool only touches the selection. Turn it off to work on the whole mesh.",[11,2045,145],{"id":144},[16,2047,2048],{},"Longer how-to articles that start with the manual Blender method:",[35,2050,2051,2055,2059],{},[38,2052,2053],{},[78,2054,153],{"href":152},[38,2056,2057],{},[78,2058,160],{"href":159},[38,2060,2061],{},[78,2062,167],{"href":166},[11,2064,2066],{"id":2065},"not-what-it-is-for","Not what it is for",[16,2068,2069,2070,87],{},"QuadFix repairs what is there. It is not a remesher and it does not rebuild edge flow. See the limits listed per tool in the ",[78,2071,81],{"href":80},[11,2073,2075],{"id":2074},"related","Related",[35,2077,2078,2083,2087],{},[38,2079,2080,2081],{},"Product page: ",[78,2082,32],{"href":260},[38,2084,2085],{},[78,2086,1989],{"href":127},[38,2088,2089,2090,319,2093,408,2096],{},"Guides: ",[78,2091,2092],{"href":152},"fill a hole with quads",[78,2094,2095],{"href":159},"convert n-gons to quads",[78,2097,2098],{"href":166},"clean up an imported STL",{"title":237,"searchDepth":238,"depth":238,"links":2100},[2101,2102,2103,2104,2105,2106],{"id":1953,"depth":238,"text":1954},{"id":1963,"depth":238,"text":1964},{"id":1999,"depth":238,"text":2000},{"id":144,"depth":238,"text":145},{"id":2065,"depth":238,"text":2066},{"id":2074,"depth":238,"text":2075},"Documentation for the QuadFix Blender add-on: install, every panel option, step-by-step workflows, troubleshooting for each message and the full changelog.",{},1,"---\ntitle: \"QuadFix documentation\"\ndescription: \"Documentation for the QuadFix Blender add-on: install, every panel option, step-by-step workflows, troubleshooting for each message and the full changelog.\"\naddon: quadfix\norder: 1\nupdated: 2026-11-16\n---\n\n## What QuadFix is\n\nQuadFix is a Blender add-on for repairing meshes with quads. It fills holes, bridges edge loops, converts triangles and n-gons, cleans up Boolean and imported meshes and unions objects with a clean seam. This documentation covers version 1.4.5 on Blender 4.2 and newer. For a short pitch and the price, see the [QuadFix product page](\u002Faddons\u002Fquadfix).\n\n## Contents\n\n- [Install](\u002Fdocs\u002Fquadfix\u002Finstall): install from the .zip, find the panel, update, uninstall, and compare Lite with the full version.\n- [Panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel): every panel, button and option with defaults and ranges.\n- [Workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows): step-by-step recipes for filling a hole, bridging two loops, cleaning after a Boolean, converting n-gons and joining objects.\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting): the messages you can see and how to fix each cause.\n- [Changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog): what changed in each version.\n\n## The idea in one minute\n\n1. Open the 3D viewport sidebar with `N` and choose the **QuadFix** tab.\n2. Select a mesh object and press `Tab` for Edit Mode.\n3. Press **Select Non-Quads & Holes** to see what is wrong. The counts appear at the bottom of the panel.\n4. Select the part you want to fix, or press `A` for everything, and press the tool you need.\n5. Read the last-result line at the bottom of the panel. `Ctrl+Z` (`Cmd+Z` on Mac) undoes the step.\n\nThe **Only Selected** option is on by default, so a tool only touches the selection. Turn it off to work on the whole mesh.\n\n## Guides\n\nLonger how-to articles that start with the manual Blender method:\n\n- [Fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads)\n- [Convert n-gons to quads](\u002Fguides\u002Fngons-to-quads)\n- [Clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n\n## Not what it is for\n\nQuadFix repairs what is there. It is not a remesher and it does not rebuild edge flow. See the limits listed per tool in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":1948,"description":2107},"docs\u002Fquadfix\u002Findex","NGk1W3281NMRBq-f-v1Sqme11QIKCV7-p8kWI6tYJuc",{"id":2115,"title":2116,"addon":276,"body":2117,"description":2364,"extension":255,"meta":2365,"navigation":259,"order":238,"path":139,"rawbody":2366,"seo":2367,"stem":2368,"updated":268,"__hash__":2369},"docs\u002Fdocs\u002Fquadfix\u002Finstall.md","Install QuadFix in Blender",{"type":8,"value":2118,"toc":2355},[2119,2121,2128,2132,2145,2165,2168,2172,2187,2197,2202,2206,2217,2221,2226,2230,2240,2325,2335,2337],[11,2120,133],{"id":132},[16,2122,2123,2124,2127],{},"QuadFix is a Blender extension and needs Blender 4.2 or newer. It uses only Blender's own Python and ",[332,2125,2126],{},"bmesh",", so there is nothing else to install and no internet connection is needed.",[11,2129,2131],{"id":2130},"install-from-the-zip","Install from the .zip",[16,2133,2134,2135,2139,2140,2144],{},"Download the .zip from ",[78,2136,201],{"href":2137,"rel":2138},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[180]," or ",[78,2141,207],{"href":2142,"rel":2143},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[180],". Do not unzip it.",[462,2146,2147,2153,2159,2162],{},[38,2148,2149,2150,87],{},"In Blender open ",[30,2151,2152],{},"Edit > Preferences > Get Extensions",[38,2154,2155,2156,87],{},"Click the small arrow menu at the top right of the window and choose ",[30,2157,2158],{},"Install from Disk",[38,2160,2161],{},"Pick the .zip file.",[38,2163,2164],{},"Make sure the add-on is enabled in the list.",[16,2166,2167],{},"Instead of steps 1 to 3 you can drag the .zip file into the Blender window and confirm the install.",[11,2169,2171],{"id":2170},"where-the-panel-appears","Where the panel appears",[462,2173,2174,2177,2182],{},[38,2175,2176],{},"Select a mesh object in the 3D viewport.",[38,2178,350,2179,2181],{},[332,2180,768],{}," to open the sidebar.",[38,2183,2184,2185,87],{},"Open the tab named ",[30,2186,32],{},[16,2188,2189,2190,2192,2193,2196],{},"The tab is available in Object Mode and in Edit Mode. The mesh tools need Edit Mode and appear greyed out in Object Mode, with a note to press ",[332,2191,334],{},". The union tool needs Object Mode and is greyed out in Edit Mode. At the bottom of the tab a footer panel shows the installed version, for example ",[332,2194,2195],{},"QuadFix v1.4.5",", and the result of the last operation.",[16,2198,2199,2200,87],{},"Everything is described in the ",[78,2201,81],{"href":80},[11,2203,2205],{"id":2204},"update","Update",[16,2207,428,2208,2210,2211,2213,2214,2216],{},[30,2209,2152],{},", use ",[30,2212,2158],{}," with the new .zip and confirm that it replaces the old version. Updates for the 1.x line are free. The ",[78,2215,234],{"href":233}," lists what each version changed.",[11,2218,2220],{"id":2219},"uninstall","Uninstall",[16,2222,428,2223,2225],{},[30,2224,2152],{},", find QuadFix in the list of installed extensions and remove it. Your meshes are not changed by removing the add-on.",[11,2227,2229],{"id":2228},"lite-or-full","Lite or full",[16,2231,2232,2233,2236,2237,2239],{},"The free ",[78,2234,185],{"href":178,"rel":2235},[180]," is a separate extension. Its sidebar tab is named ",[30,2238,185],{},". Download its .zip from the Releases page on GitHub and install it the same way.",[614,2241,2242,2255],{},[617,2243,2244],{},[620,2245,2246,2249,2252],{},[623,2247,2248],{},"Tool",[623,2250,2251],{},"Lite (free)",[623,2253,2254],{},"Full ($12)",[636,2256,2257,2266,2274,2282,2291,2300,2309,2317],{},[620,2258,2259,2261,2264],{},[641,2260,66],{},[641,2262,2263],{},"yes",[641,2265,2263],{},[620,2267,2268,2270,2272],{},[641,2269,54],{},[641,2271,2263],{},[641,2273,2263],{},[620,2275,2276,2278,2280],{},[641,2277,778],{},[641,2279,2263],{},[641,2281,2263],{},[620,2283,2284,2287,2289],{},[641,2285,2286],{},"Only Selected, last-result report, undo",[641,2288,2263],{},[641,2290,2263],{},[620,2292,2293,2295,2298],{},[641,2294,42],{},[641,2296,2297],{},"no",[641,2299,2263],{},[620,2301,2302,2305,2307],{},[641,2303,2304],{},"Match Triangle Meshes option",[641,2306,2297],{},[641,2308,2263],{},[620,2310,2311,2313,2315],{},[641,2312,48],{},[641,2314,2297],{},[641,2316,2263],{},[620,2318,2319,2321,2323],{},[641,2320,72],{},[641,2322,2297],{},[641,2324,2263],{},[16,2326,2327,2328,2330,2331,2334],{},"Both versions support Blender 4.2 and newer. To see the tools in action first, try the ",[78,2329,1313],{"href":85}," with Lite for the three shared tools, or read the ",[78,2332,2333],{"href":260},"product page"," for the full list.",[11,2336,2075],{"id":2074},[35,2338,2339,2343,2347],{},[38,2340,2080,2341],{},[78,2342,32],{"href":260},[38,2344,2345],{},[78,2346,1989],{"href":127},[38,2348,2089,2349,319,2351,408,2353],{},[78,2350,2092],{"href":152},[78,2352,2095],{"href":159},[78,2354,2098],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":2356},[2357,2358,2359,2360,2361,2362,2363],{"id":132,"depth":238,"text":133},{"id":2130,"depth":238,"text":2131},{"id":2170,"depth":238,"text":2171},{"id":2204,"depth":238,"text":2205},{"id":2219,"depth":238,"text":2220},{"id":2228,"depth":238,"text":2229},{"id":2074,"depth":238,"text":2075},"Install QuadFix from its .zip in Blender 4.2 or newer, find the QuadFix sidebar tab, update or remove it, and compare QuadFix Lite with the full version.",{},"---\ntitle: \"Install QuadFix in Blender\"\ndescription: \"Install QuadFix from its .zip in Blender 4.2 or newer, find the QuadFix sidebar tab, update or remove it, and compare QuadFix Lite with the full version.\"\naddon: quadfix\norder: 2\nupdated: 2026-11-16\n---\n\n## Requirements\n\nQuadFix is a Blender extension and needs Blender 4.2 or newer. It uses only Blender's own Python and `bmesh`, so there is nothing else to install and no internet connection is needed.\n\n## Install from the .zip\n\nDownload the .zip from [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix) or [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix). Do not unzip it.\n\n1. In Blender open **Edit > Preferences > Get Extensions**.\n2. Click the small arrow menu at the top right of the window and choose **Install from Disk**.\n3. Pick the .zip file.\n4. Make sure the add-on is enabled in the list.\n\nInstead of steps 1 to 3 you can drag the .zip file into the Blender window and confirm the install.\n\n## Where the panel appears\n\n1. Select a mesh object in the 3D viewport.\n2. Press `N` to open the sidebar.\n3. Open the tab named **QuadFix**.\n\nThe tab is available in Object Mode and in Edit Mode. The mesh tools need Edit Mode and appear greyed out in Object Mode, with a note to press `Tab`. The union tool needs Object Mode and is greyed out in Edit Mode. At the bottom of the tab a footer panel shows the installed version, for example `QuadFix v1.4.5`, and the result of the last operation.\n\nEverything is described in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Update\n\nOpen **Edit > Preferences > Get Extensions**, use **Install from Disk** with the new .zip and confirm that it replaces the old version. Updates for the 1.x line are free. The [changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog) lists what each version changed.\n\n## Uninstall\n\nOpen **Edit > Preferences > Get Extensions**, find QuadFix in the list of installed extensions and remove it. Your meshes are not changed by removing the add-on.\n\n## Lite or full\n\nThe free [QuadFix Lite](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite) is a separate extension. Its sidebar tab is named **QuadFix Lite**. Download its .zip from the Releases page on GitHub and install it the same way.\n\n| Tool | Lite (free) | Full ($12) |\n|---|---|---|\n| Select Non-Quads & Holes | yes | yes |\n| N-gons to Quads | yes | yes |\n| Clean & Quad | yes | yes |\n| Only Selected, last-result report, undo | yes | yes |\n| Fill Holes with Quads | no | yes |\n| Match Triangle Meshes option | no | yes |\n| Bridge to Quads | no | yes |\n| Union to Quads | no | yes |\n\nBoth versions support Blender 4.2 and newer. To see the tools in action first, try the [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows) with Lite for the three shared tools, or read the [product page](\u002Faddons\u002Fquadfix) for the full list.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":2116,"description":2364},"docs\u002Fquadfix\u002Finstall","WZjJS8gh-7dp-bvT-cnw-6NOH1LBg-EJ2YkhCGAqfKI",{"id":2371,"title":2372,"addon":276,"body":2373,"description":2958,"extension":255,"meta":2959,"navigation":259,"order":1337,"path":80,"rawbody":2960,"seo":2961,"stem":2962,"updated":268,"__hash__":2963},"docs\u002Fdocs\u002Fquadfix\u002Fpanel.md","QuadFix panel reference: every option",{"type":8,"value":2374,"toc":2946},[2375,2379,2387,2408,2419,2422,2425,2450,2453,2456,2483,2486,2489,2533,2536,2550,2555,2559,2614,2620,2623,2643,2648,2651,2714,2717,2720,2729,2733,2785,2788,2791,2808,2813,2816,2871,2877,2891,2901,2904,2908,2926,2928],[11,2376,2378],{"id":2377},"layout-of-the-tab","Layout of the tab",[16,2380,124,2381,2383,2384,2386],{},[30,2382,32],{}," tab in the 3D viewport sidebar (",[332,2385,768],{},") has three panels, from top to bottom:",[462,2388,2389,2394,2400],{},[38,2390,2391,2393],{},[30,2392,32],{},": the Edit Mode tools, described below.",[38,2395,2396,2399],{},[30,2397,2398],{},"Union (Object Mode)",": the Union to Quads tool.",[38,2401,2402,2404,2405,87],{},[30,2403,2195],{},": a footer with the version and the result of the last operation. Before any run it reads ",[332,2406,2407],{},"Last result: none yet",[16,2409,2410,2411,2414,2415,2418],{},"In Object Mode the first panel shows ",[332,2412,2413],{},"Edit Mode tools: press Tab"," and its controls are greyed out. In Edit Mode the union panel shows ",[332,2416,2417],{},"Object Mode tool: press Tab"," and is greyed out. Every tool therefore stays visible, but only the ones that fit the current mode can be pressed.",[16,2420,2421],{},"All operations are normal Blender undo steps.",[11,2423,1267],{"id":2424},"only-selected",[614,2426,2427,2438],{},[617,2428,2429],{},[620,2430,2431,2434,2436],{},[623,2432,2433],{},"Control",[623,2435,1481],{},[623,2437,1478],{},[636,2439,2440],{},[620,2441,2442,2444,2447],{},[641,2443,1267],{},[641,2445,2446],{},"Restricts the tools to the selected geometry. Off means the whole mesh.",[641,2448,2449],{},"On",[16,2451,2452],{},"It applies to Fill Holes, N-gons to Quads and Clean & Quad. Select Non-Quads & Holes always looks at the whole mesh, and Bridge to Quads always uses the selected edges.",[11,2454,66],{"id":2455},"select-non-quads-holes",[614,2457,2458,2468],{},[617,2459,2460],{},[620,2461,2462,2464,2466],{},[623,2463,2433],{},[623,2465,1481],{},[623,2467,1478],{},[636,2469,2470],{},[620,2471,2472,2474,2480],{},[641,2473,66],{},[641,2475,2476,2477,87],{},"Clears the selection, then selects every face that is not a quad (triangles and n-gons) and every boundary edge (open hole edges). The counts appear in the footer as ",[332,2478,2479],{},"N non-quad faces, N boundary edges",[641,2481,2482],{},"Button",[16,2484,2485],{},"Use it first to see what needs work, and again at the end to check what remains. Note that the outer rim of an open sheet counts as boundary edges too.",[11,2487,682],{"id":2488},"holes",[614,2490,2491,2502],{},[617,2492,2493],{},[620,2494,2495,2497,2499],{},[623,2496,2433],{},[623,2498,1481],{},[623,2500,2501],{},"Default and range",[636,2503,2504,2513,2524],{},[620,2505,2506,2508,2511],{},[641,2507,42],{},[641,2509,2510],{},"Fills open holes and closed boundary loops with quads. It grows a grid across the hole, relaxes it onto the surface around it and checks the result for folds. Gaps between two loops (for example a cut band) are bridged. Odd loops are handled.",[641,2512,2482],{},[620,2514,2515,2518,2521],{},[641,2516,2517],{},"Grid Span",[641,2519,2520],{},"Number of grid columns used for the grid fill. 0 lets QuadFix choose.",[641,2522,2523],{},"0, minimum 0",[620,2525,2526,2528,2531],{},[641,2527,803],{},[641,2529,2530],{},"When at least 70 percent of the faces around the filled area are triangles (a scan), the new patch is triangulated too, so it blends in. Turn it off to keep quads.",[641,2532,2449],{},[16,2534,2535],{},"What gets filled: with Only Selected on, a hole is filled only when its whole boundary loop is selected. A half-selected loop is skipped and counted in the report. The outer border of a flat open sheet, such as a plane, terrain or cloth, is skipped as not being a hole. Round holes on curved surfaces, band cuts, stepped holes and rings between two loops are rebuilt as grids.",[16,2537,2538,2539,2542,2543,2139,2546,2549],{},"The footer reads, for example, ",[332,2540,2541],{},"Filled 2 loop(s). Now: 1480 quads \u002F 12 tris \u002F 0 n-gons",". If nothing qualifies you see ",[332,2544,2545],{},"No boundary edges (holes) in selection",[332,2547,2548],{},"Nothing to fill:"," with the reason (outer borders, partly selected holes).",[1622,2551,2552],{},[16,2553,2554],{},"Fill Holes fills every fully selected closed loop, including openings you may not think of as holes, such as eye sockets on a character mesh. Select only the holes you want.",[11,2556,2558],{"id":2557},"bridge","Bridge",[614,2560,2561,2571],{},[617,2562,2563],{},[620,2564,2565,2567,2569],{},[623,2566,2433],{},[623,2568,1481],{},[623,2570,2501],{},[636,2572,2573,2582,2592,2603],{},[620,2574,2575,2577,2580],{},[641,2576,48],{},[641,2578,2579],{},"Connects two selected edge loops, or two selected open edge chains, with a strip of quads. Needs Edge select mode. Works with unequal edge counts up to 4 to 1.",[641,2581,2482],{},[620,2583,2584,2587,2590],{},[641,2585,2586],{},"Auto Cuts",[641,2588,2589],{},"Adds loops between the two sides so the quads come out roughly square.",[641,2591,2449],{},[620,2593,2594,2597,2600],{},[641,2595,2596],{},"Cuts",[641,2598,2599],{},"Number of loops added between the sides. Only used when Auto Cuts is off.",[641,2601,2602],{},"0, range 0 to 64",[620,2604,2605,2608,2611],{},[641,2606,2607],{},"Smoothness",[641,2609,2610],{},"0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them.",[641,2612,2613],{},"0, range 0 to 1",[16,2615,2616,2617,87],{},"The three options appear in Blender's Adjust Last Operation panel after you run Bridge to Quads, so you can change them and see the result update. The panel itself shows the hint ",[332,2618,2619],{},"Select two edge loops or chains",[16,2621,2622],{},"Notes on how it behaves:",[35,2624,2625,2628,2631,2634,2637,2640],{},[38,2626,2627],{},"Both sides must be the same kind: two closed loops or two open chains.",[38,2629,2630],{},"Where the counts differ, quads are reduced in rows of up to 3 to 1. A bigger ratio gets extra rows in between. If the total number of edges on both sides is odd, one triangle is unavoidable and it is selected with the strip.",[38,2632,2633],{},"On tubes the default straight strip (Smoothness 0) is the cleanest. Raise Smoothness where the two sides are tilted against each other. If a smoothed strip would fold, QuadFix falls back to the straight strip and says so in the report.",[38,2635,2636],{},"The result is checked for non-quads, non-manifold edges, zero-area faces, folds, twists and inconsistent winding. If a check fails, the strip is removed and the edges that caused the problem are selected.",[38,2638,2639],{},"Material and smooth shading of the new faces are copied from the faces beside each side.",[38,2641,2642],{},"A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.",[16,2644,2538,2645,87],{},[332,2646,2647],{},"Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s)",[11,2649,1533],{"id":2650},"quads",[614,2652,2653,2663],{},[617,2654,2655],{},[620,2656,2657,2659,2661],{},[623,2658,2433],{},[623,2660,1481],{},[623,2662,2501],{},[636,2664,2665,2674,2685,2695,2704],{},[620,2666,2667,2669,2672],{},[641,2668,54],{},[641,2670,2671],{},"Triangulates the selected triangles and n-gons and joins the triangles into quads.",[641,2673,2482],{},[620,2675,2676,2679,2682],{},[641,2677,2678],{},"Face Angle",[641,2680,2681],{},"Largest angle between the normals of two triangles that may be joined into a quad.",[641,2683,2684],{},"90 degrees, range 0 to 180",[620,2686,2687,2690,2693],{},[641,2688,2689],{},"Shape Angle",[641,2691,2692],{},"Largest deviation from a rectangle that is accepted for a new quad.",[641,2694,2684],{},[620,2696,2697,2699,2702],{},[641,2698,1694],{},[641,2700,2701],{},"Leaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans.",[641,2703,2449],{},[620,2705,2706,2708,2711],{},[641,2707,1901],{},[641,2709,2710],{},"Joins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes.",[641,2712,2713],{},"Off",[16,2715,2716],{},"Lower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.",[16,2718,2719],{},"A large n-gon that came from dissolving a rectangular patch of a grid (a clean rectangle of at least 8 corners with equal opposite sides) is opened and refilled like a hole, so the grid is rebuilt instead of turning into a diamond pattern. If that fill fails, the n-gon is put back and converted the usual way.",[16,2721,2538,2722,2725,2726,87],{},[332,2723,2724],{},"n-gons 4→0, tris 120→8, quads 300→412",". With nothing to do you see ",[332,2727,2728],{},"Nothing to convert (all quads or flat n-gons)",[11,2730,2732],{"id":2731},"boolean-import-cleanup","Boolean \u002F Import Cleanup",[614,2734,2735,2745],{},[617,2736,2737],{},[620,2738,2739,2741,2743],{},[623,2740,2433],{},[623,2742,1481],{},[623,2744,2501],{},[636,2746,2747,2756,2766,2776],{},[620,2748,2749,2751,2754],{},[641,2750,60],{},[641,2752,2753],{},"Runs the cleanup chain described below.",[641,2755,2482],{},[620,2757,2758,2760,2763],{},[641,2759,369],{},[641,2761,2762],{},"Vertices closer than this are merged. Also the threshold for removing degenerate geometry.",[641,2764,2765],{},"0.0001, minimum 0, shown with 5 decimals",[620,2767,2768,2770,2773],{},[641,2769,792],{},[641,2771,2772],{},"Angle for the limited dissolve.",[641,2774,2775],{},"5 degrees, range 0 to 90",[620,2777,2778,2780,2783],{},[641,2779,796],{},[641,2781,2782],{},"Does not dissolve edges marked sharp or seam.",[641,2784,2449],{},[16,2786,2787],{},"The Face Angle, Shape Angle, Keep Planar N-gons and Aggressive Quads options from the Quads box also apply to the triangle-joining step of Clean & Quad.",[16,2789,2790],{},"In order, Clean & Quad:",[462,2792,2793,2796,2799,2802,2805],{},[38,2794,2795],{},"Merges doubles within Merge Distance.",[38,2797,2798],{},"Dissolves degenerate geometry and deletes loose edges and vertices.",[38,2800,2801],{},"Applies a limited dissolve at the Dissolve Angle, only around triangles and n-gons and open edges. Between two quads the grid is already clean and is left alone, and triangle fans at poles of spheres and cylinder caps are recognised as clean and kept.",[38,2803,2804],{},"Triangulates the remaining non-quads and joins them into quads. Flat n-gons that were already in the mesh stay when Keep Planar N-gons is on, while n-gons created by the dissolve are always converted.",[38,2806,2807],{},"Recalculates the face normals.",[16,2809,2538,2810,87],{},[332,2811,2812],{},"verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0",[11,2814,2398],{"id":2815},"union-object-mode",[614,2817,2818,2828],{},[617,2819,2820],{},[620,2821,2822,2824,2826],{},[623,2823,2433],{},[623,2825,1481],{},[623,2827,2501],{},[636,2829,2830,2839,2850,2861],{},[620,2831,2832,2834,2837],{},[641,2833,72],{},[641,2835,2836],{},"Needs at least two selected mesh objects. The active object stays and receives the others. Runs an exact Boolean union and rebuilds every seam as a strip of quads.",[641,2838,2482],{},[620,2840,2841,2844,2847],{},[641,2842,2843],{},"Rings",[641,2845,2846],{},"Number of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result.",[641,2848,2849],{},"Auto, or 1, 2, 3",[620,2851,2852,2855,2858],{},[641,2853,2854],{},"Max Shape Change %",[641,2856,2857],{},"Largest distance the rebuilt seam may move from the plain Boolean surface, in percent of the object size. A seam that would move more is rejected and stays a plain Boolean.",[641,2859,2860],{},"2.0, range 0.1 to 20",[620,2862,2863,2866,2869],{},[641,2864,2865],{},"Keep Originals Hidden",[641,2867,2868],{},"Hides the other selected objects instead of deleting them.",[641,2870,2449],{},[16,2872,2873,2874,87],{},"The three options appear in Adjust Last Operation after the run. The panel itself shows ",[332,2875,2876],{},"Select 2+ meshes, the active one stays",[16,2878,2879,2880,2883,2884,572,2887,2890],{},"How it works: each object gets its own marker materials during the Boolean so that the seam is exactly where faces from different objects meet. Materials are restored afterwards. The result replaces the mesh of the active object (the new mesh is named after the old one with ",[332,2881,2882],{},"_union"," at the end). The other objects are hidden, and ",[30,2885,2886],{},"Object > Show\u002FHide > Reveal Hidden",[332,2888,2889],{},"Alt+H",") brings them back.",[16,2892,2538,2893,2896,2897,2900],{},[332,2894,2895],{},"Union: 2 seam loop(s) rebuilt. Mesh: quads 1820, tris 6, n-gons 0",". If some seams could not be rebuilt cleanly the text adds ",[332,2898,2899],{},"N left as plain boolean"," and the message is a warning.",[16,2902,2903],{},"Limits: UVs are not generated for the new strip. Seams that run through holes in your input are skipped. On very dense meshes with different density on the two sides the strip is all quads but zig-zags. Closed, overlapping meshes work best.",[11,2905,2907],{"id":2906},"where-to-go-next","Where to go next",[35,2909,2910,2915,2921],{},[38,2911,2912,2913,87],{},"Step-by-step use of these tools: ",[78,2914,1313],{"href":85},[38,2916,2917,2918,87],{},"Something refused or looked wrong: ",[78,2919,2920],{"href":127},"troubleshooting",[38,2922,2923,2924,87],{},"Overview and price: ",[78,2925,1960],{"href":260},[11,2927,2075],{"id":2074},[35,2929,2930,2934,2938],{},[38,2931,2080,2932],{},[78,2933,32],{"href":260},[38,2935,2936],{},[78,2937,1989],{"href":127},[38,2939,2089,2940,319,2942,408,2944],{},[78,2941,2092],{"href":152},[78,2943,2095],{"href":159},[78,2945,2098],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":2947},[2948,2949,2950,2951,2952,2953,2954,2955,2956,2957],{"id":2377,"depth":238,"text":2378},{"id":2424,"depth":238,"text":1267},{"id":2455,"depth":238,"text":66},{"id":2488,"depth":238,"text":682},{"id":2557,"depth":238,"text":2558},{"id":2650,"depth":238,"text":1533},{"id":2731,"depth":238,"text":2732},{"id":2815,"depth":238,"text":2398},{"id":2906,"depth":238,"text":2907},{"id":2074,"depth":238,"text":2075},"Reference for every QuadFix control in Blender: Only Selected, Select Non-Quads & Holes, Fill Holes, Bridge, N-gons to Quads, Clean & Quad and Union to Quads.",{},"---\ntitle: \"QuadFix panel reference: every option\"\ndescription: \"Reference for every QuadFix control in Blender: Only Selected, Select Non-Quads & Holes, Fill Holes, Bridge, N-gons to Quads, Clean & Quad and Union to Quads.\"\naddon: quadfix\norder: 3\nupdated: 2026-11-16\n---\n\n## Layout of the tab\n\nThe **QuadFix** tab in the 3D viewport sidebar (`N`) has three panels, from top to bottom:\n\n1. **QuadFix**: the Edit Mode tools, described below.\n2. **Union (Object Mode)**: the Union to Quads tool.\n3. **QuadFix v1.4.5**: a footer with the version and the result of the last operation. Before any run it reads `Last result: none yet`.\n\nIn Object Mode the first panel shows `Edit Mode tools: press Tab` and its controls are greyed out. In Edit Mode the union panel shows `Object Mode tool: press Tab` and is greyed out. Every tool therefore stays visible, but only the ones that fit the current mode can be pressed.\n\nAll operations are normal Blender undo steps.\n\n## Only Selected\n\n| Control | What it does | Default |\n|---|---|---|\n| Only Selected | Restricts the tools to the selected geometry. Off means the whole mesh. | On |\n\nIt applies to Fill Holes, N-gons to Quads and Clean & Quad. Select Non-Quads & Holes always looks at the whole mesh, and Bridge to Quads always uses the selected edges.\n\n## Select Non-Quads & Holes\n\n| Control | What it does | Default |\n|---|---|---|\n| Select Non-Quads & Holes | Clears the selection, then selects every face that is not a quad (triangles and n-gons) and every boundary edge (open hole edges). The counts appear in the footer as `N non-quad faces, N boundary edges`. | Button |\n\nUse it first to see what needs work, and again at the end to check what remains. Note that the outer rim of an open sheet counts as boundary edges too.\n\n## Holes\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Fill Holes with Quads | Fills open holes and closed boundary loops with quads. It grows a grid across the hole, relaxes it onto the surface around it and checks the result for folds. Gaps between two loops (for example a cut band) are bridged. Odd loops are handled. | Button |\n| Grid Span | Number of grid columns used for the grid fill. 0 lets QuadFix choose. | 0, minimum 0 |\n| Match Triangle Meshes | When at least 70 percent of the faces around the filled area are triangles (a scan), the new patch is triangulated too, so it blends in. Turn it off to keep quads. | On |\n\nWhat gets filled: with Only Selected on, a hole is filled only when its whole boundary loop is selected. A half-selected loop is skipped and counted in the report. The outer border of a flat open sheet, such as a plane, terrain or cloth, is skipped as not being a hole. Round holes on curved surfaces, band cuts, stepped holes and rings between two loops are rebuilt as grids.\n\nThe footer reads, for example, `Filled 2 loop(s). Now: 1480 quads \u002F 12 tris \u002F 0 n-gons`. If nothing qualifies you see `No boundary edges (holes) in selection` or `Nothing to fill:` with the reason (outer borders, partly selected holes).\n\n> Fill Holes fills every fully selected closed loop, including openings you may not think of as holes, such as eye sockets on a character mesh. Select only the holes you want.\n\n## Bridge\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Bridge to Quads | Connects two selected edge loops, or two selected open edge chains, with a strip of quads. Needs Edge select mode. Works with unequal edge counts up to 4 to 1. | Button |\n| Auto Cuts | Adds loops between the two sides so the quads come out roughly square. | On |\n| Cuts | Number of loops added between the sides. Only used when Auto Cuts is off. | 0, range 0 to 64 |\n| Smoothness | 0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them. | 0, range 0 to 1 |\n\nThe three options appear in Blender's Adjust Last Operation panel after you run Bridge to Quads, so you can change them and see the result update. The panel itself shows the hint `Select two edge loops or chains`.\n\nNotes on how it behaves:\n\n- Both sides must be the same kind: two closed loops or two open chains.\n- Where the counts differ, quads are reduced in rows of up to 3 to 1. A bigger ratio gets extra rows in between. If the total number of edges on both sides is odd, one triangle is unavoidable and it is selected with the strip.\n- On tubes the default straight strip (Smoothness 0) is the cleanest. Raise Smoothness where the two sides are tilted against each other. If a smoothed strip would fold, QuadFix falls back to the straight strip and says so in the report.\n- The result is checked for non-quads, non-manifold edges, zero-area faces, folds, twists and inconsistent winding. If a check fails, the strip is removed and the edges that caused the problem are selected.\n- Material and smooth shading of the new faces are copied from the faces beside each side.\n- A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.\n\nThe footer reads, for example, `Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s)`.\n\n## Quads\n\n| Control | What it does | Default and range |\n|---|---|---|\n| N-gons to Quads | Triangulates the selected triangles and n-gons and joins the triangles into quads. | Button |\n| Face Angle | Largest angle between the normals of two triangles that may be joined into a quad. | 90 degrees, range 0 to 180 |\n| Shape Angle | Largest deviation from a rectangle that is accepted for a new quad. | 90 degrees, range 0 to 180 |\n| Keep Planar N-gons | Leaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans. | On |\n| Aggressive Quads | Joins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes. | Off |\n\nLower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.\n\nA large n-gon that came from dissolving a rectangular patch of a grid (a clean rectangle of at least 8 corners with equal opposite sides) is opened and refilled like a hole, so the grid is rebuilt instead of turning into a diamond pattern. If that fill fails, the n-gon is put back and converted the usual way.\n\nThe footer reads, for example, `n-gons 4→0, tris 120→8, quads 300→412`. With nothing to do you see `Nothing to convert (all quads or flat n-gons)`.\n\n## Boolean \u002F Import Cleanup\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Clean & Quad (Boolean Prep) | Runs the cleanup chain described below. | Button |\n| Merge Distance | Vertices closer than this are merged. Also the threshold for removing degenerate geometry. | 0.0001, minimum 0, shown with 5 decimals |\n| Dissolve Angle | Angle for the limited dissolve. | 5 degrees, range 0 to 90 |\n| Keep Sharp Edges | Does not dissolve edges marked sharp or seam. | On |\n\nThe Face Angle, Shape Angle, Keep Planar N-gons and Aggressive Quads options from the Quads box also apply to the triangle-joining step of Clean & Quad.\n\nIn order, Clean & Quad:\n\n1. Merges doubles within Merge Distance.\n2. Dissolves degenerate geometry and deletes loose edges and vertices.\n3. Applies a limited dissolve at the Dissolve Angle, only around triangles and n-gons and open edges. Between two quads the grid is already clean and is left alone, and triangle fans at poles of spheres and cylinder caps are recognised as clean and kept.\n4. Triangulates the remaining non-quads and joins them into quads. Flat n-gons that were already in the mesh stay when Keep Planar N-gons is on, while n-gons created by the dissolve are always converted.\n5. Recalculates the face normals.\n\nThe footer reads, for example, `verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0`.\n\n## Union (Object Mode)\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Union to Quads | Needs at least two selected mesh objects. The active object stays and receives the others. Runs an exact Boolean union and rebuilds every seam as a strip of quads. | Button |\n| Rings | Number of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result. | Auto, or 1, 2, 3 |\n| Max Shape Change % | Largest distance the rebuilt seam may move from the plain Boolean surface, in percent of the object size. A seam that would move more is rejected and stays a plain Boolean. | 2.0, range 0.1 to 20 |\n| Keep Originals Hidden | Hides the other selected objects instead of deleting them. | On |\n\nThe three options appear in Adjust Last Operation after the run. The panel itself shows `Select 2+ meshes, the active one stays`.\n\nHow it works: each object gets its own marker materials during the Boolean so that the seam is exactly where faces from different objects meet. Materials are restored afterwards. The result replaces the mesh of the active object (the new mesh is named after the old one with `_union` at the end). The other objects are hidden, and **Object > Show\u002FHide > Reveal Hidden** (`Alt+H`) brings them back.\n\nThe footer reads, for example, `Union: 2 seam loop(s) rebuilt. Mesh: quads 1820, tris 6, n-gons 0`. If some seams could not be rebuilt cleanly the text adds `N left as plain boolean` and the message is a warning.\n\nLimits: UVs are not generated for the new strip. Seams that run through holes in your input are skipped. On very dense meshes with different density on the two sides the strip is all quads but zig-zags. Closed, overlapping meshes work best.\n\n## Where to go next\n\n- Step-by-step use of these tools: [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows).\n- Something refused or looked wrong: [troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting).\n- Overview and price: [QuadFix product page](\u002Faddons\u002Fquadfix).\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":2372,"description":2958},"docs\u002Fquadfix\u002Fpanel","Tf8eiqn-ALmSnySIKrsT520o6c231qEdFmf767Owd2Y",{"id":2965,"title":2966,"addon":276,"body":2967,"description":3297,"extension":255,"meta":3298,"navigation":259,"order":3299,"path":85,"rawbody":3300,"seo":3301,"stem":3302,"updated":268,"__hash__":3303},"docs\u002Fdocs\u002Fquadfix\u002Fworkflows.md","QuadFix workflows: step-by-step recipes",{"type":8,"value":2968,"toc":3288},[2969,2986,2990,2993,3027,3033,3039,3047,3051,3054,3096,3101,3105,3108,3145,3151,3157,3163,3167,3170,3207,3215,3219,3222,3256,3259,3263,3268,3270],[16,2970,2971,2972,2974,2975,2977,2978,2980,2981,572,2983,2985],{},"Each workflow uses the tools exactly as they are named in the ",[30,2973,32],{}," sidebar tab. Open it with ",[332,2976,768],{},". The options are explained in the ",[78,2979,81],{"href":80},". After every step, read the result line at the bottom of the panel, and use ",[332,2982,2034],{},[332,2984,2037],{}," on Mac) if you do not like the result.",[11,2987,2989],{"id":2988},"close-holes-with-fill-holes-with-quads","Close holes with Fill Holes with Quads",[16,2991,2992],{},"Use this for deleted faces, scan gaps and openings in imported meshes.",[462,2994,2995,3000,3005,3008,3017,3021],{},[38,2996,2997,2998,2017],{},"Select the mesh and press ",[332,2999,334],{},[38,3001,350,3002,3004],{},[30,3003,66],{},". Boundary edges are selected and the panel shows how many there are.",[38,3006,3007],{},"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.",[38,3009,3010,3011,3013,3014,3016],{},"Leave ",[30,3012,1267],{}," on. Leave ",[30,3015,2517],{}," at 0 for an automatic choice.",[38,3018,350,3019,87],{},[30,3020,42],{},[38,3022,3023,3024,87],{},"Read the result, for example ",[332,3025,3026],{},"Filled 3 loop(s). Now: ... quads \u002F ... tris \u002F ... n-gons",[16,3028,3029],{},[91,3030],{"alt":3031,"src":3032},"Blender sphere with large holes in the surface, shown before the Fill Holes with Quads step","\u002Fmedia\u002Fquadfix-holes-sphere-before.jpg",[16,3034,3035],{},[91,3036],{"alt":3037,"src":3038},"The same sphere after Fill Holes with Quads: the holes are closed with a continuous quad grid","\u002Fmedia\u002Fquadfix-holes-sphere-after.jpg",[16,3040,3041,3042,3044,3045,87],{},"If the mesh around the hole is made of triangles, the patch is triangulated as well so it matches. To get quads anyway, untick ",[30,3043,803],{}," and run it again from undo. For the manual way to do this in Blender, read ",[78,3046,2092],{"href":152},[11,3048,3050],{"id":3049},"bridge-two-edge-loops","Bridge two edge loops",[16,3052,3053],{},"Use this to connect two openings, or two open chains of edges, when they have different numbers of edges.",[462,3055,3056,3063,3074,3077,3081,3093],{},[38,3057,350,3058,3060,3061,218],{},[332,3059,334],{}," for Edit Mode and switch to Edge select mode (press ",[332,3062,472],{},[38,3064,3065,3066,3069,3070,3073],{},"Select the first loop with ",[332,3067,3068],{},"Alt"," and click, then add the second one with ",[332,3071,3072],{},"Shift+Alt"," and click. Both sides must be open (boundary) edges.",[38,3075,3076],{},"Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.",[38,3078,350,3079,87],{},[30,3080,48],{},[38,3082,3083,3084,3086,3087,3089,3090,3092],{},"Open the Adjust Last Operation panel. Leave ",[30,3085,2586],{}," on for roughly square quads, or switch it off and set ",[30,3088,2596],{},". Raise ",[30,3091,2607],{}," if the two sides are tilted against each other and you want the strip to follow the surface.",[38,3094,3095],{},"The new strip is selected. The report says how many quads, rows and reductions were made.",[16,3097,3098,3099,87],{},"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 ",[78,3100,2920],{"href":127},[11,3102,3104],{"id":3103},"clean-up-after-a-boolean-or-an-import","Clean up after a Boolean or an import",[16,3106,3107],{},"Use this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.",[462,3109,3110,3113,3121,3127,3133,3138,3142],{},[38,3111,3112],{},"Apply the Boolean modifier if it is still a modifier.",[38,3114,350,3115,3117,3118,3120],{},[332,3116,334],{}," and then ",[30,3119,66],{}," to see the state of the mesh. Note the counts.",[38,3122,3123,3124,3126],{},"Select the whole mesh with ",[332,3125,338],{},", or select only the area around the cut.",[38,3128,3129,3130,3132],{},"Check ",[30,3131,369],{},". 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.",[38,3134,3010,3135,3137],{},[30,3136,796],{}," on if you have marked sharp edges or seams that must survive.",[38,3139,350,3140,87],{},[30,3141,60],{},[38,3143,3144],{},"Read the result: vertex count, then quads, triangles and n-gons before and after.",[16,3146,3147],{},[91,3148],{"alt":3149,"src":3150},"Cube with a Boolean cut, triangles and n-gons around the cut, before Clean and Quad","\u002Fmedia\u002Fquadfix-boolean-cleanup-before.jpg",[16,3152,3153],{},[91,3154],{"alt":3155,"src":3156},"The same cube after Clean & Quad: clean quads around the cut","\u002Fmedia\u002Fquadfix-boolean-cleanup-after.jpg",[16,3158,124,3159,3162],{},[78,3160,3161],{"href":166},"guide to cleaning up an imported STL"," goes through the same steps on a full import.",[11,3164,3166],{"id":3165},"convert-triangles-and-n-gons-to-quads","Convert triangles and n-gons to quads",[16,3168,3169],{},"Use this on triangulated scans, imported meshes or n-gons you want to subdivide.",[462,3171,3172,3178,3183,3189,3193],{},[38,3173,3174,3175,3177],{},"In Edit Mode, press ",[30,3176,66],{}," to see how many triangles and n-gons there are.",[38,3179,3180,3181,87],{},"Select the faces to convert, or press ",[332,3182,338],{},[38,3184,3185,3186,3188],{},"Decide about flat n-gons. ",[30,3187,1694],{}," is on by default and leaves them alone, which is right for CAD surfaces and flat caps. Switch it off for scans.",[38,3190,350,3191,87],{},[30,3192,54],{},[38,3194,3195,3196,3198,3199,3201,3202,408,3204,3206],{},"Look at the result, for example ",[332,3197,2724],{},". For fewer triangles, switch on ",[30,3200,1901],{}," or raise ",[30,3203,2678],{},[30,3205,2689],{},", undo, and run it again. For more regular quads, lower them.",[16,3208,3209,3210,3212,3213,87],{},"Faces that are still triangles after the run are triangles QuadFix could not pair without breaking the limits you set. Select them with ",[30,3211,66],{},". More detail in ",[78,3214,2095],{"href":159},[11,3216,3218],{"id":3217},"union-meshes-with-a-clean-seam","Union meshes with a clean seam",[16,3220,3221],{},"Use this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.",[462,3223,3224,3227,3235,3244,3247],{},[38,3225,3226],{},"In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.",[38,3228,3229,3230,3232,3233,87],{},"In the ",[30,3231,2398],{}," panel, press ",[30,3234,72],{},[38,3236,3237,3238,3240,3241,3243],{},"Open Adjust Last Operation. Leave ",[30,3239,2843],{}," on Auto unless a seam came out badly. Raise ",[30,3242,2854],{}," only if the report says seams were left as a plain Boolean and you accept a larger shape change.",[38,3245,3246],{},"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.",[38,3248,3249,3250,3252,3253,3255],{},"The other objects are hidden. Use ",[30,3251,2886],{}," to bring them back, or switch off ",[30,3254,2865],{}," to delete them.",[16,3257,3258],{},"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.",[11,3260,3262],{"id":3261},"check-your-work","Check your work",[16,3264,350,3265,3267],{},[30,3266,66],{}," 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.",[11,3269,2075],{"id":2074},[35,3271,3272,3276,3280],{},[38,3273,2080,3274],{},[78,3275,32],{"href":260},[38,3277,3278],{},[78,3279,1989],{"href":127},[38,3281,2089,3282,319,3284,408,3286],{},[78,3283,2092],{"href":152},[78,3285,2095],{"href":159},[78,3287,2098],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":3289},[3290,3291,3292,3293,3294,3295,3296],{"id":2988,"depth":238,"text":2989},{"id":3049,"depth":238,"text":3050},{"id":3103,"depth":238,"text":3104},{"id":3165,"depth":238,"text":3166},{"id":3217,"depth":238,"text":3218},{"id":3261,"depth":238,"text":3262},{"id":2074,"depth":238,"text":2075},"Step-by-step QuadFix workflows in Blender: fill a hole with quads, bridge two edge loops, clean up after a Boolean, convert n-gons and union meshes.",{},4,"---\ntitle: \"QuadFix workflows: step-by-step recipes\"\ndescription: \"Step-by-step QuadFix workflows in Blender: fill a hole with quads, bridge two edge loops, clean up after a Boolean, convert n-gons and union meshes.\"\naddon: quadfix\norder: 4\nupdated: 2026-11-16\n---\n\nEach 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](\u002Fdocs\u002Fquadfix\u002Fpanel). 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.\n\n## Close holes with Fill Holes with Quads\n\nUse this for deleted faces, scan gaps and openings in imported meshes.\n\n1. Select the mesh and press `Tab` for Edit Mode.\n2. Press **Select Non-Quads & Holes**. Boundary edges are selected and the panel shows how many there are.\n3. 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.\n4. Leave **Only Selected** on. Leave **Grid Span** at 0 for an automatic choice.\n5. Press **Fill Holes with Quads**.\n6. Read the result, for example `Filled 3 loop(s). Now: ... quads \u002F ... tris \u002F ... n-gons`.\n\n![Blender sphere with large holes in the surface, shown before the Fill Holes with Quads step](\u002Fmedia\u002Fquadfix-holes-sphere-before.jpg)\n\n![The same sphere after Fill Holes with Quads: the holes are closed with a continuous quad grid](\u002Fmedia\u002Fquadfix-holes-sphere-after.jpg)\n\nIf 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](\u002Fguides\u002Ffill-hole-with-quads).\n\n## Bridge two edge loops\n\nUse this to connect two openings, or two open chains of edges, when they have different numbers of edges.\n\n1. Press `Tab` for Edit Mode and switch to Edge select mode (press `2`).\n2. Select the first loop with `Alt` and click, then add the second one with `Shift+Alt` and click. Both sides must be open (boundary) edges.\n3. Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.\n4. Press **Bridge to Quads**.\n5. 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.\n6. The new strip is selected. The report says how many quads, rows and reductions were made.\n\nIf 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](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting).\n\n## Clean up after a Boolean or an import\n\nUse this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.\n\n1. Apply the Boolean modifier if it is still a modifier.\n2. Press `Tab` and then **Select Non-Quads & Holes** to see the state of the mesh. Note the counts.\n3. Select the whole mesh with `A`, or select only the area around the cut.\n4. 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.\n5. Leave **Keep Sharp Edges** on if you have marked sharp edges or seams that must survive.\n6. Press **Clean & Quad (Boolean Prep)**.\n7. Read the result: vertex count, then quads, triangles and n-gons before and after.\n\n![Cube with a Boolean cut, triangles and n-gons around the cut, before Clean and Quad](\u002Fmedia\u002Fquadfix-boolean-cleanup-before.jpg)\n\n![The same cube after Clean & Quad: clean quads around the cut](\u002Fmedia\u002Fquadfix-boolean-cleanup-after.jpg)\n\nThe [guide to cleaning up an imported STL](\u002Fguides\u002Fclean-up-imported-stl) goes through the same steps on a full import.\n\n## Convert triangles and n-gons to quads\n\nUse this on triangulated scans, imported meshes or n-gons you want to subdivide.\n\n1. In Edit Mode, press **Select Non-Quads & Holes** to see how many triangles and n-gons there are.\n2. Select the faces to convert, or press `A`.\n3. 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.\n4. Press **N-gons to Quads**.\n5. 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.\n\nFaces 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](\u002Fguides\u002Fngons-to-quads).\n\n## Union meshes with a clean seam\n\nUse this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.\n\n1. In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.\n2. In the **Union (Object Mode)** panel, press **Union to Quads**.\n3. 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.\n4. 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.\n5. The other objects are hidden. Use **Object > Show\u002FHide > Reveal Hidden** to bring them back, or switch off **Keep Originals Hidden** to delete them.\n\nBoth 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.\n\n## Check your work\n\nPress **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.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":2966,"description":3297},"docs\u002Fquadfix\u002Fworkflows","01JysYD94Vx69fa0CdP2RxmGBDfrWl54m9_aAqZFo5A",{"id":3305,"title":3306,"addon":276,"body":3307,"description":3671,"extension":255,"meta":3672,"navigation":259,"order":3673,"path":127,"rawbody":3674,"seo":3675,"stem":3676,"updated":268,"__hash__":3677},"docs\u002Fdocs\u002Fquadfix\u002Ftroubleshooting.md","QuadFix troubleshooting: errors and fixes",{"type":8,"value":3308,"toc":3640},[3309,3314,3318,3324,3328,3340,3344,3361,3365,3372,3376,3379,3383,3389,3393,3399,3403,3406,3410,3415,3419,3422,3426,3429,3433,3436,3440,3443,3447,3450,3454,3460,3464,3473,3477,3492,3496,3499,3503,3512,3516,3527,3531,3540,3544,3549,3553,3556,3560,3566,3570,3582,3586,3589,3593,3605,3609,3620,3622],[16,3310,3311,3312,87],{},"Messages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the ",[78,3313,81],{"href":80},[11,3315,3317],{"id":3316},"why-are-the-quadfix-buttons-greyed-out","Why are the QuadFix buttons greyed out?",[16,3319,3320,3321,3323],{},"The mesh tools only work in Edit Mode, and Union to Quads only works in Object Mode. The panel shows the other group greyed out with a hint to press ",[332,3322,334],{},". Union to Quads also needs at least two selected mesh objects, with a mesh as the active object. If the tab does not show at all, check that the 3D viewport is in Object Mode or Edit Mode, and not Sculpt or Paint.",[11,3325,3327],{"id":3326},"why-does-fill-holes-say-no-boundary-edges-holes-in-selection","Why does Fill Holes say \"No boundary edges (holes) in selection\"?",[16,3329,3330,3331,3333,3334,3336,3337,3339],{},"Fill Holes with ",[30,3332,1267],{}," on looks for open edges in your selection. Either nothing selected is a boundary edge, or the mesh has no holes. Press ",[30,3335,66],{}," to select the open edges, then press ",[30,3338,42],{},". A mesh without any open edge, such as a closed sphere, has no holes.",[11,3341,3343],{"id":3342},"why-does-fill-holes-say-nothing-to-fill","Why does Fill Holes say \"Nothing to fill\"?",[16,3345,3346,3347,3350,3351,3354,3355,3357,3358,3360],{},"The message lists the reasons. ",[332,3348,3349],{},"outer border(s)"," means the loop is the rim of a flat open sheet such as a plane, terrain or cloth, which QuadFix does not treat as a hole. ",[332,3352,3353],{},"partly selected hole(s)"," means only some edges of a hole loop are selected. Select the full loop, or turn ",[30,3356,1267],{}," off to consider the whole mesh. Select by edge loop with ",[332,3359,3068],{}," and click on one edge of the hole.",[11,3362,3364],{"id":3363},"why-was-one-of-my-holes-skipped","Why was one of my holes skipped?",[16,3366,3367,3368,3371],{},"Two cases: its loop is only partly selected, or it looks like the outer border of a flat sheet. Both are counted in the result line, for example ",[332,3369,3370],{},"1 partly selected hole(s) skipped",". Fix the selection and run the tool again.",[11,3373,3375],{"id":3374},"why-did-fill-holes-close-an-opening-i-wanted-open","Why did Fill Holes close an opening I wanted open?",[16,3377,3378],{},"Fill Holes closes every closed boundary loop that is fully selected. That includes things such as eye sockets or the end of a tube. Select only the holes you want closed before pressing the button, or undo and run it again.",[11,3380,3382],{"id":3381},"why-does-the-patch-have-triangles-instead-of-quads","Why does the patch have triangles instead of quads?",[16,3384,3385,3386,3388],{},"If at least 70 percent of the faces around the patch are triangles, ",[30,3387,803],{}," makes the patch triangular on purpose. Untick it for a quad patch. Otherwise a very irregular outline can leave a few triangles, which are also counted in the result line.",[11,3390,3392],{"id":3391},"why-does-bridge-to-quads-say-select-two-edge-loops-or-open-edge-chains-edge-select-mode","Why does Bridge to Quads say \"select two edge loops or open edge chains (Edge select mode)\"?",[16,3394,3395,3396,3398],{},"Nothing usable is selected. Switch to Edge select mode with ",[332,3397,472],{},", select two loops or chains of boundary edges, then run the tool again. In Vertex select mode, edges that already have faces on both sides are ignored, so only the open edges count.",[11,3400,3402],{"id":3401},"why-does-bridge-to-quads-say-selected-edges-already-have-faces-on-both-sides","Why does Bridge to Quads say selected edges \"already have faces on both sides\"?",[16,3404,3405],{},"Bridge needs open edges, those with a face on at most one side. The message selects the offending edges. If you are in Face select mode, QuadFix switches to Edge select mode so you can see them. Deselect those edges and select the boundary of the openings instead.",[11,3407,3409],{"id":3408},"why-does-bridge-to-quads-say-only-one-loop-or-chain-is-selected","Why does Bridge to Quads say \"only one loop or chain is selected\"?",[16,3411,3412,3413,87],{},"It needs exactly two sides. A single hole is closed with ",[30,3414,42],{},[11,3416,3418],{"id":3417},"why-does-bridge-to-quads-say-separate-loops-or-chains-are-selected-select-exactly-two","Why does Bridge to Quads say \"separate loops or chains are selected: select exactly two\"?",[16,3420,3421],{},"More than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.",[11,3423,3425],{"id":3424},"why-does-bridge-to-quads-say-the-selection-branches-or-a-loop-touches-itself","Why does Bridge to Quads say the selection branches or a loop touches itself?",[16,3427,3428],{},"The selection must be two simple loops or chains. Where three or more selected edges meet in one vertex, the selection branches. A loop that crosses itself is refused as well. Select the two loops separately and leave out the forks.",[11,3430,3432],{"id":3431},"why-does-bridge-to-quads-say-one-side-is-a-closed-loop-and-the-other-an-open-chain","Why does Bridge to Quads say \"one side is a closed loop and the other an open chain\"?",[16,3434,3435],{},"Both sides must be the same kind: two closed loops or two open chains. Select a matching pair.",[11,3437,3439],{"id":3438},"why-does-bridge-to-quads-say-the-sides-have-different-edge-counts-for-example-40-and-8-edges","Why does Bridge to Quads say the sides have different edge counts, for example 40 and 8 edges?",[16,3441,3442],{},"The two sides may differ by at most 4 to 1 in edge count. Add edge loops to the sparser side, or remove some from the dense one, until the ratio is 4 to 1 or less. Then bridge them.",[11,3444,3446],{"id":3445},"why-does-bridge-to-quads-say-a-loop-needs-at-least-three-edges","Why does Bridge to Quads say \"a loop needs at least three edges\"?",[16,3448,3449],{},"A closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.",[11,3451,3453],{"id":3452},"why-does-bridge-to-quads-say-the-two-sides-face-opposite-ways","Why does Bridge to Quads say the two sides face opposite ways?",[16,3455,3456,3457,3459],{},"The faces beside the two loops have normals that point in opposite directions. Use ",[30,3458,431],{},", then bridge again. If the normals are correct and the surfaces really face each other, that is the case this check is meant to refuse.",[11,3461,3463],{"id":3462},"why-does-bridge-to-quads-say-a-loop-has-no-length","Why does Bridge to Quads say a loop \"has no length\"?",[16,3465,3466,3467,311,3470,3472],{},"The vertices of a selected loop sit on top of each other. Run ",[30,3468,3469],{},"Mesh > Clean Up > Merge by Distance",[30,3471,778],{},", then select the loops again.",[11,3474,3476],{"id":3475},"why-does-bridge-to-quads-say-the-strip-folds-twists-or-no-quad-layout","Why does Bridge to Quads say \"the strip folds\", \"twists\" or \"no quad layout\"?",[16,3478,3479,3480,3482,3483,3485,3486,3488,3489,3491],{},"The result is checked, and a strip that would fold back on itself, twist into bow-tie quads, create non-manifold edges or zero-area faces is removed. The mesh is left as it was and the problem edges are selected. Try a different ",[30,3481,2596],{}," value with ",[30,3484,2586],{}," off, set ",[30,3487,2607],{}," to 0, or choose loops that are less tilted against each other. A closed loop of three edges is better closed with ",[30,3490,42],{},". If the two sides are already connected by faces, the message says so, and there is nothing to bridge. If you ask for Smoothness and the curved rows would fold, QuadFix tries the straight strip and the report says that Smoothness was dropped.",[11,3493,3495],{"id":3494},"why-does-the-bridge-leave-one-triangle","Why does the bridge leave one triangle?",[16,3497,3498],{},"A quad mesh has an even number of boundary edges. When the two sides have an odd number of edges in total, one triangle cannot be avoided. The report says so and selects the triangle with the strip. Add or remove one edge on one side to get an all-quad strip.",[11,3500,3502],{"id":3501},"why-does-n-gons-to-quads-say-nothing-to-convert-all-quads-or-flat-n-gons","Why does N-gons to Quads say \"Nothing to convert (all quads or flat n-gons)\"?",[16,3504,3505,3506,3508,3509,3511],{},"Everything in the selection is already a quad, or is a flat n-gon protected by ",[30,3507,1694],{},". Switch that option off to convert flat n-gons as well. Check that ",[30,3510,1267],{}," is not hiding the faces you want to process.",[11,3513,3515],{"id":3514},"why-do-triangles-remain-after-n-gons-to-quads-or-clean-quad","Why do triangles remain after N-gons to Quads or Clean & Quad?",[16,3517,3518,3519,408,3521,3523,3524,3526],{},"Two triangles are joined only when the angles are within ",[30,3520,2678],{},[30,3522,2689],{},". Triangles with no suitable neighbour stay. Raise the angles or switch on ",[30,3525,1901],{},", then run it again from undo. Irregular scans keep some triangles whatever you do. QuadFix does not rebuild edge flow, so for a full retopology you need a remesher.",[11,3528,3530],{"id":3529},"why-did-clean-quad-leave-some-n-gons-or-triangles-alone","Why did Clean & Quad leave some n-gons or triangles alone?",[16,3532,3533,3534,3536,3537,3539],{},"Flat n-gons that were in the mesh before the run stay when ",[30,3535,1694],{}," is on. Triangle fans at the poles of spheres and the caps of cylinders are recognised as clean and left alone. Edges marked sharp or seam are not dissolved while ",[30,3538,796],{}," is on.",[11,3541,3543],{"id":3542},"why-did-clean-quad-change-nothing-near-my-corners","Why did Clean & Quad change nothing near my corners?",[16,3545,3546,3547,87],{},"The dissolve step only works around triangles, n-gons and open edges. A grid of quads is considered clean. That keeps a finely curved quad surface from being torn up. If the mesh really needs a stronger cleanup, raise ",[30,3548,792],{},[11,3550,3552],{"id":3551},"why-does-union-to-quads-say-the-objects-do-not-intersect-nothing-was-changed","Why does Union to Quads say \"The objects do not intersect: nothing was changed\"?",[16,3554,3555],{},"The Boolean found no seam between the objects. Move them so their surfaces cross, or check that they are overlapping meshes and not two separate pieces.",[11,3557,3559],{"id":3558},"why-does-union-to-quads-say-boolean-union-produced-no-faces","Why does Union to Quads say \"Boolean union produced no faces\"?",[16,3561,3562,3563,3565],{},"Blender's exact Boolean returned an empty mesh. The message asks whether both meshes are closed and overlap. Make sure both objects are closed meshes, with no holes and no flipped normals. Use ",[30,3564,66],{}," on each object to check for open boundary edges, and fill the holes first.",[11,3567,3569],{"id":3568},"why-does-union-to-quads-report-left-as-plain-boolean","Why does Union to Quads report \"left as plain boolean\"?",[16,3571,3572,3573,3575,3576,3578,3579,3581],{},"Some seams were not rebuilt cleanly. The result of such a seam would have changed the surface by more than ",[30,3574,2854],{},", or a seam runs through a hole in one of the inputs, or no acceptable strip was found. That seam keeps the normal Boolean result and the message is a warning with the count. Try a different ",[30,3577,2843],{}," value instead of Auto, or raise ",[30,3580,2854],{}," a little. Fill holes in the inputs before the union.",[11,3583,3585],{"id":3584},"why-is-the-union-to-quads-seam-a-zig-zag","Why is the Union to Quads seam a zig-zag?",[16,3587,3588],{},"On dense meshes with very different density on the two sides, the strip is all quads but visibly zig-zags. Make the two meshes more similar in density before the union. UVs for the new strip are not generated, so unwrap after the union.",[11,3590,3592],{"id":3591},"where-did-the-other-objects-go-after-union-to-quads","Where did the other objects go after Union to Quads?",[16,3594,3595,3596,3598,3599,3601,3602,3604],{},"They are hidden. Use ",[30,3597,2886],{},". With ",[30,3600,2865],{}," off they are deleted, so ",[332,3603,2034],{}," is the way back.",[11,3606,3608],{"id":3607},"how-do-i-undo-a-quadfix-step","How do I undo a QuadFix step?",[16,3610,3611,3612,572,3614,3616,3617,3619],{},"Every tool is a normal Blender undo step. ",[332,3613,2034],{},[332,3615,2037],{}," on Mac) reverts it in one go. If you are still stuck, write to ",[78,3618,212],{"href":211}," and attach a small .blend file that shows the problem.",[11,3621,2075],{"id":2074},[35,3623,3624,3628,3632],{},[38,3625,2080,3626],{},[78,3627,32],{"href":260},[38,3629,3630],{},[78,3631,1983],{"href":85},[38,3633,2089,3634,319,3636,408,3638],{},[78,3635,2092],{"href":152},[78,3637,2095],{"href":159},[78,3639,2098],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":3641},[3642,3643,3644,3645,3646,3647,3648,3649,3650,3651,3652,3653,3654,3655,3656,3657,3658,3659,3660,3661,3662,3663,3664,3665,3666,3667,3668,3669,3670],{"id":3316,"depth":238,"text":3317},{"id":3326,"depth":238,"text":3327},{"id":3342,"depth":238,"text":3343},{"id":3363,"depth":238,"text":3364},{"id":3374,"depth":238,"text":3375},{"id":3381,"depth":238,"text":3382},{"id":3391,"depth":238,"text":3392},{"id":3401,"depth":238,"text":3402},{"id":3408,"depth":238,"text":3409},{"id":3417,"depth":238,"text":3418},{"id":3424,"depth":238,"text":3425},{"id":3431,"depth":238,"text":3432},{"id":3438,"depth":238,"text":3439},{"id":3445,"depth":238,"text":3446},{"id":3452,"depth":238,"text":3453},{"id":3462,"depth":238,"text":3463},{"id":3475,"depth":238,"text":3476},{"id":3494,"depth":238,"text":3495},{"id":3501,"depth":238,"text":3502},{"id":3514,"depth":238,"text":3515},{"id":3529,"depth":238,"text":3530},{"id":3542,"depth":238,"text":3543},{"id":3551,"depth":238,"text":3552},{"id":3558,"depth":238,"text":3559},{"id":3568,"depth":238,"text":3569},{"id":3584,"depth":238,"text":3585},{"id":3591,"depth":238,"text":3592},{"id":3607,"depth":238,"text":3608},{"id":2074,"depth":238,"text":2075},"Fix common QuadFix problems in Blender: greyed-out buttons, holes that are not filled, Bridge to Quads refusals, leftover triangles and Union to Quads warnings.",{},8,"---\ntitle: \"QuadFix troubleshooting: errors and fixes\"\ndescription: \"Fix common QuadFix problems in Blender: greyed-out buttons, holes that are not filled, Bridge to Quads refusals, leftover triangles and Union to Quads warnings.\"\naddon: quadfix\norder: 8\nupdated: 2026-11-16\n---\n\nMessages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Why are the QuadFix buttons greyed out?\n\nThe mesh tools only work in Edit Mode, and Union to Quads only works in Object Mode. The panel shows the other group greyed out with a hint to press `Tab`. Union to Quads also needs at least two selected mesh objects, with a mesh as the active object. If the tab does not show at all, check that the 3D viewport is in Object Mode or Edit Mode, and not Sculpt or Paint.\n\n## Why does Fill Holes say \"No boundary edges (holes) in selection\"?\n\nFill Holes with **Only Selected** on looks for open edges in your selection. Either nothing selected is a boundary edge, or the mesh has no holes. Press **Select Non-Quads & Holes** to select the open edges, then press **Fill Holes with Quads**. A mesh without any open edge, such as a closed sphere, has no holes.\n\n## Why does Fill Holes say \"Nothing to fill\"?\n\nThe message lists the reasons. `outer border(s)` means the loop is the rim of a flat open sheet such as a plane, terrain or cloth, which QuadFix does not treat as a hole. `partly selected hole(s)` means only some edges of a hole loop are selected. Select the full loop, or turn **Only Selected** off to consider the whole mesh. Select by edge loop with `Alt` and click on one edge of the hole.\n\n## Why was one of my holes skipped?\n\nTwo cases: its loop is only partly selected, or it looks like the outer border of a flat sheet. Both are counted in the result line, for example `1 partly selected hole(s) skipped`. Fix the selection and run the tool again.\n\n## Why did Fill Holes close an opening I wanted open?\n\nFill Holes closes every closed boundary loop that is fully selected. That includes things such as eye sockets or the end of a tube. Select only the holes you want closed before pressing the button, or undo and run it again.\n\n## Why does the patch have triangles instead of quads?\n\nIf at least 70 percent of the faces around the patch are triangles, **Match Triangle Meshes** makes the patch triangular on purpose. Untick it for a quad patch. Otherwise a very irregular outline can leave a few triangles, which are also counted in the result line.\n\n## Why does Bridge to Quads say \"select two edge loops or open edge chains (Edge select mode)\"?\n\nNothing usable is selected. Switch to Edge select mode with `2`, select two loops or chains of boundary edges, then run the tool again. In Vertex select mode, edges that already have faces on both sides are ignored, so only the open edges count.\n\n## Why does Bridge to Quads say selected edges \"already have faces on both sides\"?\n\nBridge needs open edges, those with a face on at most one side. The message selects the offending edges. If you are in Face select mode, QuadFix switches to Edge select mode so you can see them. Deselect those edges and select the boundary of the openings instead.\n\n## Why does Bridge to Quads say \"only one loop or chain is selected\"?\n\nIt needs exactly two sides. A single hole is closed with **Fill Holes with Quads**.\n\n## Why does Bridge to Quads say \"separate loops or chains are selected: select exactly two\"?\n\nMore than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.\n\n## Why does Bridge to Quads say the selection branches or a loop touches itself?\n\nThe selection must be two simple loops or chains. Where three or more selected edges meet in one vertex, the selection branches. A loop that crosses itself is refused as well. Select the two loops separately and leave out the forks.\n\n## Why does Bridge to Quads say \"one side is a closed loop and the other an open chain\"?\n\nBoth sides must be the same kind: two closed loops or two open chains. Select a matching pair.\n\n## Why does Bridge to Quads say the sides have different edge counts, for example 40 and 8 edges?\n\nThe two sides may differ by at most 4 to 1 in edge count. Add edge loops to the sparser side, or remove some from the dense one, until the ratio is 4 to 1 or less. Then bridge them.\n\n## Why does Bridge to Quads say \"a loop needs at least three edges\"?\n\nA closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.\n\n## Why does Bridge to Quads say the two sides face opposite ways?\n\nThe faces beside the two loops have normals that point in opposite directions. Use **Mesh > Normals > Recalculate Outside**, then bridge again. If the normals are correct and the surfaces really face each other, that is the case this check is meant to refuse.\n\n## Why does Bridge to Quads say a loop \"has no length\"?\n\nThe vertices of a selected loop sit on top of each other. Run **Mesh > Clean Up > Merge by Distance**, or **Clean & Quad**, then select the loops again.\n\n## Why does Bridge to Quads say \"the strip folds\", \"twists\" or \"no quad layout\"?\n\nThe result is checked, and a strip that would fold back on itself, twist into bow-tie quads, create non-manifold edges or zero-area faces is removed. The mesh is left as it was and the problem edges are selected. Try a different **Cuts** value with **Auto Cuts** off, set **Smoothness** to 0, or choose loops that are less tilted against each other. A closed loop of three edges is better closed with **Fill Holes with Quads**. If the two sides are already connected by faces, the message says so, and there is nothing to bridge. If you ask for Smoothness and the curved rows would fold, QuadFix tries the straight strip and the report says that Smoothness was dropped.\n\n## Why does the bridge leave one triangle?\n\nA quad mesh has an even number of boundary edges. When the two sides have an odd number of edges in total, one triangle cannot be avoided. The report says so and selects the triangle with the strip. Add or remove one edge on one side to get an all-quad strip.\n\n## Why does N-gons to Quads say \"Nothing to convert (all quads or flat n-gons)\"?\n\nEverything in the selection is already a quad, or is a flat n-gon protected by **Keep Planar N-gons**. Switch that option off to convert flat n-gons as well. Check that **Only Selected** is not hiding the faces you want to process.\n\n## Why do triangles remain after N-gons to Quads or Clean & Quad?\n\nTwo triangles are joined only when the angles are within **Face Angle** and **Shape Angle**. Triangles with no suitable neighbour stay. Raise the angles or switch on **Aggressive Quads**, then run it again from undo. Irregular scans keep some triangles whatever you do. QuadFix does not rebuild edge flow, so for a full retopology you need a remesher.\n\n## Why did Clean & Quad leave some n-gons or triangles alone?\n\nFlat n-gons that were in the mesh before the run stay when **Keep Planar N-gons** is on. Triangle fans at the poles of spheres and the caps of cylinders are recognised as clean and left alone. Edges marked sharp or seam are not dissolved while **Keep Sharp Edges** is on.\n\n## Why did Clean & Quad change nothing near my corners?\n\nThe dissolve step only works around triangles, n-gons and open edges. A grid of quads is considered clean. That keeps a finely curved quad surface from being torn up. If the mesh really needs a stronger cleanup, raise **Dissolve Angle**.\n\n## Why does Union to Quads say \"The objects do not intersect: nothing was changed\"?\n\nThe Boolean found no seam between the objects. Move them so their surfaces cross, or check that they are overlapping meshes and not two separate pieces.\n\n## Why does Union to Quads say \"Boolean union produced no faces\"?\n\nBlender's exact Boolean returned an empty mesh. The message asks whether both meshes are closed and overlap. Make sure both objects are closed meshes, with no holes and no flipped normals. Use **Select Non-Quads & Holes** on each object to check for open boundary edges, and fill the holes first.\n\n## Why does Union to Quads report \"left as plain boolean\"?\n\nSome seams were not rebuilt cleanly. The result of such a seam would have changed the surface by more than **Max Shape Change %**, or a seam runs through a hole in one of the inputs, or no acceptable strip was found. That seam keeps the normal Boolean result and the message is a warning with the count. Try a different **Rings** value instead of Auto, or raise **Max Shape Change %** a little. Fill holes in the inputs before the union.\n\n## Why is the Union to Quads seam a zig-zag?\n\nOn dense meshes with very different density on the two sides, the strip is all quads but visibly zig-zags. Make the two meshes more similar in density before the union. UVs for the new strip are not generated, so unwrap after the union.\n\n## Where did the other objects go after Union to Quads?\n\nThey are hidden. Use **Object > Show\u002FHide > Reveal Hidden**. With **Keep Originals Hidden** off they are deleted, so `Ctrl+Z` is the way back.\n\n## How do I undo a QuadFix step?\n\nEvery tool is a normal Blender undo step. `Ctrl+Z` (`Cmd+Z` on Mac) reverts it in one go. If you are still stuck, write to support@mendboxstudio.com and attach a small .blend file that shows the problem.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":3306,"description":3671},"docs\u002Fquadfix\u002Ftroubleshooting","CQNvvl5eI4l8O7afth99gPDfciv-efcqlJ5wU1xIYP8",{"id":3679,"title":3680,"addon":276,"body":3681,"description":3943,"extension":255,"meta":3944,"navigation":259,"order":3945,"path":233,"rawbody":3946,"seo":3947,"stem":3948,"updated":268,"__hash__":3949},"docs\u002Fdocs\u002Fquadfix\u002Fchangelog.md","QuadFix changelog",{"type":8,"value":3682,"toc":3922},[3683,3693,3697,3708,3712,3723,3727,3732,3736,3741,3745,3750,3754,3759,3763,3768,3772,3777,3781,3786,3790,3795,3799,3804,3808,3813,3817,3822,3826,3831,3835,3840,3844,3851,3855,3884,3888,3902,3904],[16,3684,3685,3686,3688,3689,3692],{},"Current version: 1.4.5. Updates for the 1.x line are free. Every date is in 2026. See the ",[78,3687,2333],{"href":260}," for the current feature list and ",[78,3690,3691],{"href":139},"install"," for how to update.",[11,3694,3696],{"id":3695},"_145-9-november-2026","1.4.5 (9 November 2026)",[35,3698,3699,3705],{},[38,3700,3701,3702,3704],{},"Bridge to Quads: ",[30,3703,2607],{}," now continues the surface walls on either side instead of fairing the strip.",[38,3706,3707],{},"Bridge to Quads: the angle smoothing stays inside its own row and no longer depends on object scale.",[11,3709,3711],{"id":3710},"_144-9-november-2026","1.4.4 (9 November 2026)",[35,3713,3714,3720],{},[38,3715,3716,3717,3719],{},"New tool: ",[30,3718,48],{},". It joins two edge loops or two open chains with a strip of quads, even when the edge counts differ (up to 4 to 1). It has Auto Cuts, Cuts and Smoothness options.",[38,3721,3722],{},"The strip is more even around the reductions, and reduction rows are spread out.",[11,3724,3726],{"id":3725},"_143-8-november-2026","1.4.3 (8 November 2026)",[35,3728,3729],{},[38,3730,3731],{},"Clean & Quad leaves clean quads and the triangle fans at poles of spheres and cylinder caps alone, so a clean grid is not torn up.",[11,3733,3735],{"id":3734},"_142-8-november-2026","1.4.2 (8 November 2026)",[35,3737,3738],{},[38,3739,3740],{},"N-gons to Quads refills n-gons that came from a dissolved grid patch like a hole, which rebuilds the grid instead of giving a diamond pattern.",[11,3742,3744],{"id":3743},"_141-8-november-2026","1.4.1 (8 November 2026)",[35,3746,3747],{},[38,3748,3749],{},"Fill Holes splits notched, grid-shaped holes into rectangles and grid-fills each one.",[11,3751,3753],{"id":3752},"_140-8-november-2026","1.4.0 (8 November 2026)",[35,3755,3756],{},[38,3757,3758],{},"Union to Quads: a reduction row behind dense loops, and staircase teeth are kept.",[11,3760,3762],{"id":3761},"_135-8-november-2026","1.3.5 (8 November 2026)",[35,3764,3765],{},[38,3766,3767],{},"Union to Quads: back to the narrow seam strip with a lower cost for extra rings.",[11,3769,3771],{"id":3770},"_134-8-november-2026","1.3.4 (8 November 2026)",[35,3773,3774],{},[38,3775,3776],{},"Union to Quads: wider strips are preferred in seam crevices.",[11,3778,3780],{"id":3779},"_133-7-november-2026","1.3.3 (7 November 2026)",[35,3782,3783],{},[38,3784,3785],{},"Union to Quads keeps body creases sharp through the seam strip.",[11,3787,3789],{"id":3788},"_132-7-november-2026","1.3.2 (7 November 2026)",[35,3791,3792],{},[38,3793,3794],{},"Union to Quads absorbs differences in vertex count between the two sides with quad reductions.",[11,3796,3798],{"id":3797},"_131-31-october-2026","1.3.1 (31 October 2026)",[35,3800,3801],{},[38,3802,3803],{},"Union to Quads smooths the boundary loops of the strip along the seam.",[11,3805,3807],{"id":3806},"_130-7-october-2026","1.3.0 (7 October 2026)",[35,3809,3810],{},[38,3811,3812],{},"Union to Quads matches the two sides of the seam strip by arc length, giving fewer triangles and spikes.",[11,3814,3816],{"id":3815},"_126-125-and-124-5-october-2026","1.2.6, 1.2.5 and 1.2.4 (5 October 2026)",[35,3818,3819],{},[38,3820,3821],{},"A footer panel at the bottom of the QuadFix tab shows the version and the last result. These three releases fixed its position so it is always last.",[11,3823,3825],{"id":3824},"_123-5-october-2026","1.2.3 (5 October 2026)",[35,3827,3828],{},[38,3829,3830],{},"All tools are visible in both Object Mode and Edit Mode and are greyed out when the mode does not fit.",[11,3832,3834],{"id":3833},"_122-5-october-2026","1.2.2 (5 October 2026)",[35,3836,3837],{},[38,3838,3839],{},"Union to Quads rejects folded strips and prefers narrower, less sliver-like results when Rings is Auto.",[11,3841,3843],{"id":3842},"_120-october-2026","1.2.0 (October 2026)",[35,3845,3846],{},[38,3847,3716,3848,3850],{},[30,3849,72],{},". An exact Boolean union whose seam is rebuilt as a strip of quads, with Rings, Max Shape Change % and Keep Originals Hidden options.",[11,3852,3854],{"id":3853},"_118-to-110-27-and-28-september-2026","1.1.8 to 1.1.0 (27 and 28 September 2026)",[35,3856,3857,3860,3863,3866,3869,3872,3875,3878,3881],{},[38,3858,3859],{},"1.1.8: hole patches are faired smoothly onto the surface.",[38,3861,3862],{},"1.1.7: an automatic test suite on Blender 4.2, 4.5 and 5.2, and the fixes it found.",[38,3864,3865],{},"1.1.6: Clean & Quad converts faces created by its own dissolve in Face select mode.",[38,3867,3868],{},"1.1.5: wire edges left behind when a failed fill is reverted are removed.",[38,3870,3871],{},"1.1.4: round holes on curved surfaces are rebuilt properly.",[38,3873,3874],{},"1.1.3: Clean & Quad converts n-gons created by its own dissolve regardless of Keep Planar N-gons. Fill Holes matches triangle neighbourhoods.",[38,3876,3877],{},"1.1.2: grid growth works for all closed loops, and folded results are detected and reverted.",[38,3879,3880],{},"1.1.1: new vertices are relaxed onto the surface so patches bulge like their surroundings.",[38,3882,3883],{},"1.1.0: band-shaped holes are rebuilt by growing a quad grid across the gap.",[11,3885,3887],{"id":3886},"_109-to-100-27-september-2026","1.0.9 to 1.0.0 (27 September 2026)",[35,3889,3890,3893,3896,3899],{},[38,3891,3892],{},"1.0.9: grid rows follow the grid around the hole, and each piece of a split hole is filled separately.",[38,3894,3895],{},"1.0.8 to 1.0.3: better handling of long, band-like and horseshoe-shaped holes, with checks against sliver triangles and folded quads, and consistent normals with the neighbouring faces.",[38,3897,3898],{},"1.0.2: the version label appears in the panel.",[38,3900,3901],{},"1.0.0: first release with Fill Holes with Quads, N-gons to Quads and Clean & Quad.",[11,3903,2075],{"id":2074},[35,3905,3906,3910,3914],{},[38,3907,2080,3908],{},[78,3909,32],{"href":260},[38,3911,3912],{},[78,3913,1989],{"href":127},[38,3915,2089,3916,319,3918,408,3920],{},[78,3917,2092],{"href":152},[78,3919,2095],{"href":159},[78,3921,2098],{"href":166},{"title":237,"searchDepth":238,"depth":238,"links":3923},[3924,3925,3926,3927,3928,3929,3930,3931,3932,3933,3934,3935,3936,3937,3938,3939,3940,3941,3942],{"id":3695,"depth":238,"text":3696},{"id":3710,"depth":238,"text":3711},{"id":3725,"depth":238,"text":3726},{"id":3734,"depth":238,"text":3735},{"id":3743,"depth":238,"text":3744},{"id":3752,"depth":238,"text":3753},{"id":3761,"depth":238,"text":3762},{"id":3770,"depth":238,"text":3771},{"id":3779,"depth":238,"text":3780},{"id":3788,"depth":238,"text":3789},{"id":3797,"depth":238,"text":3798},{"id":3806,"depth":238,"text":3807},{"id":3815,"depth":238,"text":3816},{"id":3824,"depth":238,"text":3825},{"id":3833,"depth":238,"text":3834},{"id":3842,"depth":238,"text":3843},{"id":3853,"depth":238,"text":3854},{"id":3886,"depth":238,"text":3887},{"id":2074,"depth":238,"text":2075},"Version history of the QuadFix Blender add-on from 1.0 to 1.4.5: new tools, hole-filling improvements, Union to Quads and Bridge to Quads changes.",{},9,"---\ntitle: \"QuadFix changelog\"\ndescription: \"Version history of the QuadFix Blender add-on from 1.0 to 1.4.5: new tools, hole-filling improvements, Union to Quads and Bridge to Quads changes.\"\naddon: quadfix\norder: 9\nupdated: 2026-11-16\n---\n\nCurrent version: 1.4.5. Updates for the 1.x line are free. Every date is in 2026. See the [product page](\u002Faddons\u002Fquadfix) for the current feature list and [install](\u002Fdocs\u002Fquadfix\u002Finstall) for how to update.\n\n## 1.4.5 (9 November 2026)\n\n- Bridge to Quads: **Smoothness** now continues the surface walls on either side instead of fairing the strip.\n- Bridge to Quads: the angle smoothing stays inside its own row and no longer depends on object scale.\n\n## 1.4.4 (9 November 2026)\n\n- New tool: **Bridge to Quads**. It joins two edge loops or two open chains with a strip of quads, even when the edge counts differ (up to 4 to 1). It has Auto Cuts, Cuts and Smoothness options.\n- The strip is more even around the reductions, and reduction rows are spread out.\n\n## 1.4.3 (8 November 2026)\n\n- Clean & Quad leaves clean quads and the triangle fans at poles of spheres and cylinder caps alone, so a clean grid is not torn up.\n\n## 1.4.2 (8 November 2026)\n\n- N-gons to Quads refills n-gons that came from a dissolved grid patch like a hole, which rebuilds the grid instead of giving a diamond pattern.\n\n## 1.4.1 (8 November 2026)\n\n- Fill Holes splits notched, grid-shaped holes into rectangles and grid-fills each one.\n\n## 1.4.0 (8 November 2026)\n\n- Union to Quads: a reduction row behind dense loops, and staircase teeth are kept.\n\n## 1.3.5 (8 November 2026)\n\n- Union to Quads: back to the narrow seam strip with a lower cost for extra rings.\n\n## 1.3.4 (8 November 2026)\n\n- Union to Quads: wider strips are preferred in seam crevices.\n\n## 1.3.3 (7 November 2026)\n\n- Union to Quads keeps body creases sharp through the seam strip.\n\n## 1.3.2 (7 November 2026)\n\n- Union to Quads absorbs differences in vertex count between the two sides with quad reductions.\n\n## 1.3.1 (31 October 2026)\n\n- Union to Quads smooths the boundary loops of the strip along the seam.\n\n## 1.3.0 (7 October 2026)\n\n- Union to Quads matches the two sides of the seam strip by arc length, giving fewer triangles and spikes.\n\n## 1.2.6, 1.2.5 and 1.2.4 (5 October 2026)\n\n- A footer panel at the bottom of the QuadFix tab shows the version and the last result. These three releases fixed its position so it is always last.\n\n## 1.2.3 (5 October 2026)\n\n- All tools are visible in both Object Mode and Edit Mode and are greyed out when the mode does not fit.\n\n## 1.2.2 (5 October 2026)\n\n- Union to Quads rejects folded strips and prefers narrower, less sliver-like results when Rings is Auto.\n\n## 1.2.0 (October 2026)\n\n- New tool: **Union to Quads**. An exact Boolean union whose seam is rebuilt as a strip of quads, with Rings, Max Shape Change % and Keep Originals Hidden options.\n\n## 1.1.8 to 1.1.0 (27 and 28 September 2026)\n\n- 1.1.8: hole patches are faired smoothly onto the surface.\n- 1.1.7: an automatic test suite on Blender 4.2, 4.5 and 5.2, and the fixes it found.\n- 1.1.6: Clean & Quad converts faces created by its own dissolve in Face select mode.\n- 1.1.5: wire edges left behind when a failed fill is reverted are removed.\n- 1.1.4: round holes on curved surfaces are rebuilt properly.\n- 1.1.3: Clean & Quad converts n-gons created by its own dissolve regardless of Keep Planar N-gons. Fill Holes matches triangle neighbourhoods.\n- 1.1.2: grid growth works for all closed loops, and folded results are detected and reverted.\n- 1.1.1: new vertices are relaxed onto the surface so patches bulge like their surroundings.\n- 1.1.0: band-shaped holes are rebuilt by growing a quad grid across the gap.\n\n## 1.0.9 to 1.0.0 (27 September 2026)\n\n- 1.0.9: grid rows follow the grid around the hole, and each piece of a split hole is filled separately.\n- 1.0.8 to 1.0.3: better handling of long, band-like and horseshoe-shaped holes, with checks against sliver triangles and folded quads, and consistent normals with the neighbouring faces.\n- 1.0.2: the version label appears in the panel.\n- 1.0.0: first release with Fill Holes with Quads, N-gons to Quads and Clean & Quad.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":3680,"description":3943},"docs\u002Fquadfix\u002Fchangelog","7arTMmN_Ib84b8873BVyFy7WGCCp5DrTO8K_LA5M6K4",1794858941685]