[{"data":1,"prerenderedAt":2558},["ShallowReactive",2],{"\u002Fdocs\u002Fquadfix\u002Fworkflows":3,"\u002Fdocs\u002Fquadfix\u002Fworkflows-siblings":415,"\u002Fdocs\u002Fquadfix\u002Fworkflows-addon":2338},{"id":4,"title":5,"addon":6,"body":7,"description":404,"extension":405,"meta":406,"navigation":407,"order":408,"path":409,"rawbody":410,"seo":411,"stem":412,"updated":413,"__hash__":414},"docs\u002Fdocs\u002Fquadfix\u002Fworkflows.md","QuadFix workflows: step-by-step recipes","quadfix",{"type":8,"value":9,"toc":393},"minimark",[10,38,43,46,90,97,103,114,118,121,169,176,180,183,224,230,236,244,248,251,295,305,309,312,352,355,359,364,368],[11,12,13,14,18,19,23,24,29,30,33,34,37],"p",{},"Each workflow uses the tools exactly as they are named in the ",[15,16,17],"strong",{},"QuadFix"," sidebar tab. Open it with ",[20,21,22],"code",{},"N",". The options are explained in the ",[25,26,28],"a",{"href":27},"\u002Fdocs\u002Fquadfix\u002Fpanel","panel reference",". After every step, read the result line at the bottom of the panel, and use ",[20,31,32],{},"Ctrl+Z"," (",[20,35,36],{},"Cmd+Z"," on Mac) if you do not like the result.",[39,40,42],"h2",{"id":41},"close-holes-with-fill-holes-with-quads","Close holes with Fill Holes with Quads",[11,44,45],{},"Use this for deleted faces, scan gaps and openings in imported meshes.",[47,48,49,57,64,67,78,84],"ol",{},[50,51,52,53,56],"li",{},"Select the mesh and press ",[20,54,55],{},"Tab"," for Edit Mode.",[50,58,59,60,63],{},"Press ",[15,61,62],{},"Select Non-Quads & Holes",". Boundary edges are selected and the panel shows how many there are.",[50,65,66],{},"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.",[50,68,69,70,73,74,77],{},"Leave ",[15,71,72],{},"Only Selected"," on. Leave ",[15,75,76],{},"Grid Span"," at 0 for an automatic choice.",[50,79,59,80,83],{},[15,81,82],{},"Fill Holes with Quads",".",[50,85,86,87,83],{},"Read the result, for example ",[20,88,89],{},"Filled 3 loop(s). Now: ... quads \u002F ... tris \u002F ... n-gons",[11,91,92],{},[93,94],"img",{"alt":95,"src":96},"Blender sphere with large holes in the surface, shown before the Fill Holes with Quads step","\u002Fmedia\u002Fquadfix-holes-sphere-before.jpg",[11,98,99],{},[93,100],{"alt":101,"src":102},"The same sphere after Fill Holes with Quads: the holes are closed with a continuous quad grid","\u002Fmedia\u002Fquadfix-holes-sphere-after.jpg",[11,104,105,106,109,110,83],{},"If the mesh around the hole is made of triangles, the patch is triangulated as well so it matches. To get quads anyway, untick ",[15,107,108],{},"Match Triangle Meshes"," and run it again from undo. For the manual way to do this in Blender, read ",[25,111,113],{"href":112},"\u002Fguides\u002Ffill-hole-with-quads","fill a hole with quads",[39,115,117],{"id":116},"bridge-two-edge-loops","Bridge two edge loops",[11,119,120],{},"Use this to connect two openings, or two open chains of edges, when they have different numbers of edges.",[47,122,123,132,143,146,151,166],{},[50,124,59,125,127,128,131],{},[20,126,55],{}," for Edit Mode and switch to Edge select mode (press ",[20,129,130],{},"2",").",[50,133,134,135,138,139,142],{},"Select the first loop with ",[20,136,137],{},"Alt"," and click, then add the second one with ",[20,140,141],{},"Shift+Alt"," and click. Both sides must be open (boundary) edges.",[50,144,145],{},"Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.",[50,147,59,148,83],{},[15,149,150],{},"Bridge to Quads",[50,152,153,154,157,158,161,162,165],{},"Open the Adjust Last Operation panel. Leave ",[15,155,156],{},"Auto Cuts"," on for roughly square quads, or switch it off and set ",[15,159,160],{},"Cuts",". Raise ",[15,163,164],{},"Smoothness"," if the two sides are tilted against each other and you want the strip to follow the surface.",[50,167,168],{},"The new strip is selected. The report says how many quads, rows and reductions were made.",[11,170,171,172,83],{},"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 ",[25,173,175],{"href":174},"\u002Fdocs\u002Fquadfix\u002Ftroubleshooting","troubleshooting",[39,177,179],{"id":178},"clean-up-after-a-boolean-or-an-import","Clean up after a Boolean or an import",[11,181,182],{},"Use this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.",[47,184,185,188,196,203,210,216,221],{},[50,186,187],{},"Apply the Boolean modifier if it is still a modifier.",[50,189,59,190,192,193,195],{},[20,191,55],{}," and then ",[15,194,62],{}," to see the state of the mesh. Note the counts.",[50,197,198,199,202],{},"Select the whole mesh with ",[20,200,201],{},"A",", or select only the area around the cut.",[50,204,205,206,209],{},"Check ",[15,207,208],{},"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.",[50,211,69,212,215],{},[15,213,214],{},"Keep Sharp Edges"," on if you have marked sharp edges or seams that must survive.",[50,217,59,218,83],{},[15,219,220],{},"Clean & Quad (Boolean Prep)",[50,222,223],{},"Read the result: vertex count, then quads, triangles and n-gons before and after.",[11,225,226],{},[93,227],{"alt":228,"src":229},"Cube with a Boolean cut, triangles and n-gons around the cut, before Clean and Quad","\u002Fmedia\u002Fquadfix-boolean-cleanup-before.jpg",[11,231,232],{},[93,233],{"alt":234,"src":235},"The same cube after Clean & Quad: clean quads around the cut","\u002Fmedia\u002Fquadfix-boolean-cleanup-after.jpg",[11,237,238,239,243],{},"The ",[25,240,242],{"href":241},"\u002Fguides\u002Fclean-up-imported-stl","guide to cleaning up an imported STL"," goes through the same steps on a full import.",[39,245,247],{"id":246},"convert-triangles-and-n-gons-to-quads","Convert triangles and n-gons to quads",[11,249,250],{},"Use this on triangulated scans, imported meshes or n-gons you want to subdivide.",[47,252,253,259,264,271,276],{},[50,254,255,256,258],{},"In Edit Mode, press ",[15,257,62],{}," to see how many triangles and n-gons there are.",[50,260,261,262,83],{},"Select the faces to convert, or press ",[20,263,201],{},[50,265,266,267,270],{},"Decide about flat n-gons. ",[15,268,269],{},"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.",[50,272,59,273,83],{},[15,274,275],{},"N-gons to Quads",[50,277,278,279,282,283,286,287,290,291,294],{},"Look at the result, for example ",[20,280,281],{},"n-gons 4→0, tris 120→8, quads 300→412",". For fewer triangles, switch on ",[15,284,285],{},"Aggressive Quads"," or raise ",[15,288,289],{},"Face Angle"," and ",[15,292,293],{},"Shape Angle",", undo, and run it again. For more regular quads, lower them.",[11,296,297,298,300,301,83],{},"Faces that are still triangles after the run are triangles QuadFix could not pair without breaking the limits you set. Select them with ",[15,299,62],{},". More detail in ",[25,302,304],{"href":303},"\u002Fguides\u002Fngons-to-quads","convert n-gons to quads",[39,306,308],{"id":307},"union-meshes-with-a-clean-seam","Union meshes with a clean seam",[11,310,311],{},"Use this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.",[47,313,314,317,327,338,341],{},[50,315,316],{},"In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.",[50,318,319,320,323,324,83],{},"In the ",[15,321,322],{},"Union (Object Mode)"," panel, press ",[15,325,326],{},"Union to Quads",[50,328,329,330,333,334,337],{},"Open Adjust Last Operation. Leave ",[15,331,332],{},"Rings"," on Auto unless a seam came out badly. Raise ",[15,335,336],{},"Max Shape Change %"," only if the report says seams were left as a plain Boolean and you accept a larger shape change.",[50,339,340],{},"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.",[50,342,343,344,347,348,351],{},"The other objects are hidden. Use ",[15,345,346],{},"Object > Show\u002FHide > Reveal Hidden"," to bring them back, or switch off ",[15,349,350],{},"Keep Originals Hidden"," to delete them.",[11,353,354],{},"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.",[39,356,358],{"id":357},"check-your-work","Check your work",[11,360,59,361,363],{},[15,362,62],{}," 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.",[39,365,367],{"id":366},"related","Related",[369,370,371,377,382],"ul",{},[50,372,373,374],{},"Product page: ",[25,375,17],{"href":376},"\u002Faddons\u002Fquadfix",[50,378,379],{},[25,380,381],{"href":174},"Troubleshooting",[50,383,384,385,387,388,290,390],{},"Guides: ",[25,386,113],{"href":112},", ",[25,389,304],{"href":303},[25,391,392],{"href":241},"clean up an imported STL",{"title":394,"searchDepth":395,"depth":395,"links":396},"",2,[397,398,399,400,401,402,403],{"id":41,"depth":395,"text":42},{"id":116,"depth":395,"text":117},{"id":178,"depth":395,"text":179},{"id":246,"depth":395,"text":247},{"id":307,"depth":395,"text":308},{"id":357,"depth":395,"text":358},{"id":366,"depth":395,"text":367},"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.","md",{},true,4,"\u002Fdocs\u002Fquadfix\u002Fworkflows","---\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":5,"description":404},"docs\u002Fquadfix\u002Fworkflows","2026-11-16","01JysYD94Vx69fa0CdP2RxmGBDfrWl54m9_aAqZFo5A",[416,581,854,1442,1688,2066],{"id":417,"title":418,"addon":6,"body":419,"description":573,"extension":405,"meta":574,"navigation":407,"order":575,"path":576,"rawbody":577,"seo":578,"stem":579,"updated":413,"__hash__":580},"docs\u002Fdocs\u002Fquadfix\u002Findex.md","QuadFix documentation",{"type":8,"value":420,"toc":565},[421,425,431,435,468,472,507,512,516,519,536,540,545,547],[39,422,424],{"id":423},"what-quadfix-is","What QuadFix is",[11,426,427,428,83],{},"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 ",[25,429,430],{"href":376},"QuadFix product page",[39,432,434],{"id":433},"contents","Contents",[369,436,437,444,450,456,461],{},[50,438,439,443],{},[25,440,442],{"href":441},"\u002Fdocs\u002Fquadfix\u002Finstall","Install",": install from the .zip, find the panel, update, uninstall, and compare Lite with the full version.",[50,445,446,449],{},[25,447,448],{"href":27},"Panel reference",": every panel, button and option with defaults and ranges.",[50,451,452,455],{},[25,453,454],{"href":409},"Workflows",": step-by-step recipes for filling a hole, bridging two loops, cleaning after a Boolean, converting n-gons and joining objects.",[50,457,458,460],{},[25,459,381],{"href":174},": the messages you can see and how to fix each cause.",[50,462,463,467],{},[25,464,466],{"href":465},"\u002Fdocs\u002Fquadfix\u002Fchangelog","Changelog",": what changed in each version.",[39,469,471],{"id":470},"the-idea-in-one-minute","The idea in one minute",[47,473,474,483,488,493,499],{},[50,475,476,477,479,480,482],{},"Open the 3D viewport sidebar with ",[20,478,22],{}," and choose the ",[15,481,17],{}," tab.",[50,484,485,486,56],{},"Select a mesh object and press ",[20,487,55],{},[50,489,59,490,492],{},[15,491,62],{}," to see what is wrong. The counts appear at the bottom of the panel.",[50,494,495,496,498],{},"Select the part you want to fix, or press ",[20,497,201],{}," for everything, and press the tool you need.",[50,500,501,502,33,504,506],{},"Read the last-result line at the bottom of the panel. ",[20,503,32],{},[20,505,36],{}," on Mac) undoes the step.",[11,508,238,509,511],{},[15,510,72],{}," option is on by default, so a tool only touches the selection. Turn it off to work on the whole mesh.",[39,513,515],{"id":514},"guides","Guides",[11,517,518],{},"Longer how-to articles that start with the manual Blender method:",[369,520,521,526,531],{},[50,522,523],{},[25,524,525],{"href":112},"Fill a hole with quads",[50,527,528],{},[25,529,530],{"href":303},"Convert n-gons to quads",[50,532,533],{},[25,534,535],{"href":241},"Clean up an imported STL",[39,537,539],{"id":538},"not-what-it-is-for","Not what it is for",[11,541,542,543,83],{},"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 ",[25,544,28],{"href":27},[39,546,367],{"id":366},[369,548,549,553,557],{},[50,550,373,551],{},[25,552,17],{"href":376},[50,554,555],{},[25,556,381],{"href":174},[50,558,384,559,387,561,290,563],{},[25,560,113],{"href":112},[25,562,304],{"href":303},[25,564,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":566},[567,568,569,570,571,572],{"id":423,"depth":395,"text":424},{"id":433,"depth":395,"text":434},{"id":470,"depth":395,"text":471},{"id":514,"depth":395,"text":515},{"id":538,"depth":395,"text":539},{"id":366,"depth":395,"text":367},"Documentation for the QuadFix Blender add-on: install, every panel option, step-by-step workflows, troubleshooting for each message and the full changelog.",{},1,"\u002Fdocs\u002Fquadfix","---\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":418,"description":573},"docs\u002Fquadfix\u002Findex","NGk1W3281NMRBq-f-v1Sqme11QIKCV7-p8kWI6tYJuc",{"id":582,"title":583,"addon":6,"body":584,"description":848,"extension":405,"meta":849,"navigation":407,"order":395,"path":441,"rawbody":850,"seo":851,"stem":852,"updated":413,"__hash__":853},"docs\u002Fdocs\u002Fquadfix\u002Finstall.md","Install QuadFix in Blender",{"type":8,"value":585,"toc":839},[586,590,597,601,617,637,640,644,659,669,674,678,691,695,700,704,716,808,819,821],[39,587,589],{"id":588},"requirements","Requirements",[11,591,592,593,596],{},"QuadFix is a Blender extension and needs Blender 4.2 or newer. It uses only Blender's own Python and ",[20,594,595],{},"bmesh",", so there is nothing else to install and no internet connection is needed.",[39,598,600],{"id":599},"install-from-the-zip","Install from the .zip",[11,602,603,604,610,611,616],{},"Download the .zip from ",[25,605,609],{"href":606,"rel":607},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[608],"nofollow","Gumroad"," or ",[25,612,615],{"href":613,"rel":614},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[608],"Superhive",". Do not unzip it.",[47,618,619,625,631,634],{},[50,620,621,622,83],{},"In Blender open ",[15,623,624],{},"Edit > Preferences > Get Extensions",[50,626,627,628,83],{},"Click the small arrow menu at the top right of the window and choose ",[15,629,630],{},"Install from Disk",[50,632,633],{},"Pick the .zip file.",[50,635,636],{},"Make sure the add-on is enabled in the list.",[11,638,639],{},"Instead of steps 1 to 3 you can drag the .zip file into the Blender window and confirm the install.",[39,641,643],{"id":642},"where-the-panel-appears","Where the panel appears",[47,645,646,649,654],{},[50,647,648],{},"Select a mesh object in the 3D viewport.",[50,650,59,651,653],{},[20,652,22],{}," to open the sidebar.",[50,655,656,657,83],{},"Open the tab named ",[15,658,17],{},[11,660,661,662,664,665,668],{},"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 ",[20,663,55],{},". 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 ",[20,666,667],{},"QuadFix v1.4.5",", and the result of the last operation.",[11,670,671,672,83],{},"Everything is described in the ",[25,673,28],{"href":27},[39,675,677],{"id":676},"update","Update",[11,679,680,681,683,684,686,687,690],{},"Open ",[15,682,624],{},", use ",[15,685,630],{}," with the new .zip and confirm that it replaces the old version. Updates for the 1.x line are free. The ",[25,688,689],{"href":465},"changelog"," lists what each version changed.",[39,692,694],{"id":693},"uninstall","Uninstall",[11,696,680,697,699],{},[15,698,624],{},", find QuadFix in the list of installed extensions and remove it. Your meshes are not changed by removing the add-on.",[39,701,703],{"id":702},"lite-or-full","Lite or full",[11,705,706,707,712,713,715],{},"The free ",[25,708,711],{"href":709,"rel":710},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite",[608],"QuadFix Lite"," is a separate extension. Its sidebar tab is named ",[15,714,711],{},". Download its .zip from the Releases page on GitHub and install it the same way.",[717,718,719,735],"table",{},[720,721,722],"thead",{},[723,724,725,729,732],"tr",{},[726,727,728],"th",{},"Tool",[726,730,731],{},"Lite (free)",[726,733,734],{},"Full ($12)",[736,737,738,748,756,765,774,783,792,800],"tbody",{},[723,739,740,743,746],{},[741,742,62],"td",{},[741,744,745],{},"yes",[741,747,745],{},[723,749,750,752,754],{},[741,751,275],{},[741,753,745],{},[741,755,745],{},[723,757,758,761,763],{},[741,759,760],{},"Clean & Quad",[741,762,745],{},[741,764,745],{},[723,766,767,770,772],{},[741,768,769],{},"Only Selected, last-result report, undo",[741,771,745],{},[741,773,745],{},[723,775,776,778,781],{},[741,777,82],{},[741,779,780],{},"no",[741,782,745],{},[723,784,785,788,790],{},[741,786,787],{},"Match Triangle Meshes option",[741,789,780],{},[741,791,745],{},[723,793,794,796,798],{},[741,795,150],{},[741,797,780],{},[741,799,745],{},[723,801,802,804,806],{},[741,803,326],{},[741,805,780],{},[741,807,745],{},[11,809,810,811,814,815,818],{},"Both versions support Blender 4.2 and newer. To see the tools in action first, try the ",[25,812,813],{"href":409},"workflows"," with Lite for the three shared tools, or read the ",[25,816,817],{"href":376},"product page"," for the full list.",[39,820,367],{"id":366},[369,822,823,827,831],{},[50,824,373,825],{},[25,826,17],{"href":376},[50,828,829],{},[25,830,381],{"href":174},[50,832,384,833,387,835,290,837],{},[25,834,113],{"href":112},[25,836,304],{"href":303},[25,838,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":840},[841,842,843,844,845,846,847],{"id":588,"depth":395,"text":589},{"id":599,"depth":395,"text":600},{"id":642,"depth":395,"text":643},{"id":676,"depth":395,"text":677},{"id":693,"depth":395,"text":694},{"id":702,"depth":395,"text":703},{"id":366,"depth":395,"text":367},"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":583,"description":848},"docs\u002Fquadfix\u002Finstall","WZjJS8gh-7dp-bvT-cnw-6NOH1LBg-EJ2YkhCGAqfKI",{"id":855,"title":856,"addon":6,"body":857,"description":1435,"extension":405,"meta":1436,"navigation":407,"order":1437,"path":27,"rawbody":1438,"seo":1439,"stem":1440,"updated":413,"__hash__":1441},"docs\u002Fdocs\u002Fquadfix\u002Fpanel.md","QuadFix panel reference: every option",{"type":8,"value":858,"toc":1423},[859,863,871,891,902,905,908,935,938,941,968,971,975,1018,1021,1035,1041,1045,1097,1103,1106,1126,1131,1135,1196,1199,1202,1210,1214,1267,1270,1273,1290,1295,1298,1350,1356,1369,1379,1382,1386,1403,1405],[39,860,862],{"id":861},"layout-of-the-tab","Layout of the tab",[11,864,238,865,867,868,870],{},[15,866,17],{}," tab in the 3D viewport sidebar (",[20,869,22],{},") has three panels, from top to bottom:",[47,872,873,878,883],{},[50,874,875,877],{},[15,876,17],{},": the Edit Mode tools, described below.",[50,879,880,882],{},[15,881,322],{},": the Union to Quads tool.",[50,884,885,887,888,83],{},[15,886,667],{},": a footer with the version and the result of the last operation. Before any run it reads ",[20,889,890],{},"Last result: none yet",[11,892,893,894,897,898,901],{},"In Object Mode the first panel shows ",[20,895,896],{},"Edit Mode tools: press Tab"," and its controls are greyed out. In Edit Mode the union panel shows ",[20,899,900],{},"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.",[11,903,904],{},"All operations are normal Blender undo steps.",[39,906,72],{"id":907},"only-selected",[717,909,910,923],{},[720,911,912],{},[723,913,914,917,920],{},[726,915,916],{},"Control",[726,918,919],{},"What it does",[726,921,922],{},"Default",[736,924,925],{},[723,926,927,929,932],{},[741,928,72],{},[741,930,931],{},"Restricts the tools to the selected geometry. Off means the whole mesh.",[741,933,934],{},"On",[11,936,937],{},"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.",[39,939,62],{"id":940},"select-non-quads-holes",[717,942,943,953],{},[720,944,945],{},[723,946,947,949,951],{},[726,948,916],{},[726,950,919],{},[726,952,922],{},[736,954,955],{},[723,956,957,959,965],{},[741,958,62],{},[741,960,961,962,83],{},"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 ",[20,963,964],{},"N non-quad faces, N boundary edges",[741,966,967],{},"Button",[11,969,970],{},"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.",[39,972,974],{"id":973},"holes","Holes",[717,976,977,988],{},[720,978,979],{},[723,980,981,983,985],{},[726,982,916],{},[726,984,919],{},[726,986,987],{},"Default and range",[736,989,990,999,1009],{},[723,991,992,994,997],{},[741,993,82],{},[741,995,996],{},"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.",[741,998,967],{},[723,1000,1001,1003,1006],{},[741,1002,76],{},[741,1004,1005],{},"Number of grid columns used for the grid fill. 0 lets QuadFix choose.",[741,1007,1008],{},"0, minimum 0",[723,1010,1011,1013,1016],{},[741,1012,108],{},[741,1014,1015],{},"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.",[741,1017,934],{},[11,1019,1020],{},"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.",[11,1022,1023,1024,1027,1028,610,1031,1034],{},"The footer reads, for example, ",[20,1025,1026],{},"Filled 2 loop(s). Now: 1480 quads \u002F 12 tris \u002F 0 n-gons",". If nothing qualifies you see ",[20,1029,1030],{},"No boundary edges (holes) in selection",[20,1032,1033],{},"Nothing to fill:"," with the reason (outer borders, partly selected holes).",[1036,1037,1038],"blockquote",{},[11,1039,1040],{},"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.",[39,1042,1044],{"id":1043},"bridge","Bridge",[717,1046,1047,1057],{},[720,1048,1049],{},[723,1050,1051,1053,1055],{},[726,1052,916],{},[726,1054,919],{},[726,1056,987],{},[736,1058,1059,1068,1077,1087],{},[723,1060,1061,1063,1066],{},[741,1062,150],{},[741,1064,1065],{},"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.",[741,1067,967],{},[723,1069,1070,1072,1075],{},[741,1071,156],{},[741,1073,1074],{},"Adds loops between the two sides so the quads come out roughly square.",[741,1076,934],{},[723,1078,1079,1081,1084],{},[741,1080,160],{},[741,1082,1083],{},"Number of loops added between the sides. Only used when Auto Cuts is off.",[741,1085,1086],{},"0, range 0 to 64",[723,1088,1089,1091,1094],{},[741,1090,164],{},[741,1092,1093],{},"0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them.",[741,1095,1096],{},"0, range 0 to 1",[11,1098,1099,1100,83],{},"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 ",[20,1101,1102],{},"Select two edge loops or chains",[11,1104,1105],{},"Notes on how it behaves:",[369,1107,1108,1111,1114,1117,1120,1123],{},[50,1109,1110],{},"Both sides must be the same kind: two closed loops or two open chains.",[50,1112,1113],{},"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.",[50,1115,1116],{},"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.",[50,1118,1119],{},"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.",[50,1121,1122],{},"Material and smooth shading of the new faces are copied from the faces beside each side.",[50,1124,1125],{},"A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.",[11,1127,1023,1128,83],{},[20,1129,1130],{},"Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s)",[39,1132,1134],{"id":1133},"quads","Quads",[717,1136,1137,1147],{},[720,1138,1139],{},[723,1140,1141,1143,1145],{},[726,1142,916],{},[726,1144,919],{},[726,1146,987],{},[736,1148,1149,1158,1168,1177,1186],{},[723,1150,1151,1153,1156],{},[741,1152,275],{},[741,1154,1155],{},"Triangulates the selected triangles and n-gons and joins the triangles into quads.",[741,1157,967],{},[723,1159,1160,1162,1165],{},[741,1161,289],{},[741,1163,1164],{},"Largest angle between the normals of two triangles that may be joined into a quad.",[741,1166,1167],{},"90 degrees, range 0 to 180",[723,1169,1170,1172,1175],{},[741,1171,293],{},[741,1173,1174],{},"Largest deviation from a rectangle that is accepted for a new quad.",[741,1176,1167],{},[723,1178,1179,1181,1184],{},[741,1180,269],{},[741,1182,1183],{},"Leaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans.",[741,1185,934],{},[723,1187,1188,1190,1193],{},[741,1189,285],{},[741,1191,1192],{},"Joins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes.",[741,1194,1195],{},"Off",[11,1197,1198],{},"Lower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.",[11,1200,1201],{},"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.",[11,1203,1023,1204,1206,1207,83],{},[20,1205,281],{},". With nothing to do you see ",[20,1208,1209],{},"Nothing to convert (all quads or flat n-gons)",[39,1211,1213],{"id":1212},"boolean-import-cleanup","Boolean \u002F Import Cleanup",[717,1215,1216,1226],{},[720,1217,1218],{},[723,1219,1220,1222,1224],{},[726,1221,916],{},[726,1223,919],{},[726,1225,987],{},[736,1227,1228,1237,1247,1258],{},[723,1229,1230,1232,1235],{},[741,1231,220],{},[741,1233,1234],{},"Runs the cleanup chain described below.",[741,1236,967],{},[723,1238,1239,1241,1244],{},[741,1240,208],{},[741,1242,1243],{},"Vertices closer than this are merged. Also the threshold for removing degenerate geometry.",[741,1245,1246],{},"0.0001, minimum 0, shown with 5 decimals",[723,1248,1249,1252,1255],{},[741,1250,1251],{},"Dissolve Angle",[741,1253,1254],{},"Angle for the limited dissolve.",[741,1256,1257],{},"5 degrees, range 0 to 90",[723,1259,1260,1262,1265],{},[741,1261,214],{},[741,1263,1264],{},"Does not dissolve edges marked sharp or seam.",[741,1266,934],{},[11,1268,1269],{},"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.",[11,1271,1272],{},"In order, Clean & Quad:",[47,1274,1275,1278,1281,1284,1287],{},[50,1276,1277],{},"Merges doubles within Merge Distance.",[50,1279,1280],{},"Dissolves degenerate geometry and deletes loose edges and vertices.",[50,1282,1283],{},"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.",[50,1285,1286],{},"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.",[50,1288,1289],{},"Recalculates the face normals.",[11,1291,1023,1292,83],{},[20,1293,1294],{},"verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0",[39,1296,322],{"id":1297},"union-object-mode",[717,1299,1300,1310],{},[720,1301,1302],{},[723,1303,1304,1306,1308],{},[726,1305,916],{},[726,1307,919],{},[726,1309,987],{},[736,1311,1312,1321,1331,1341],{},[723,1313,1314,1316,1319],{},[741,1315,326],{},[741,1317,1318],{},"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.",[741,1320,967],{},[723,1322,1323,1325,1328],{},[741,1324,332],{},[741,1326,1327],{},"Number of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result.",[741,1329,1330],{},"Auto, or 1, 2, 3",[723,1332,1333,1335,1338],{},[741,1334,336],{},[741,1336,1337],{},"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.",[741,1339,1340],{},"2.0, range 0.1 to 20",[723,1342,1343,1345,1348],{},[741,1344,350],{},[741,1346,1347],{},"Hides the other selected objects instead of deleting them.",[741,1349,934],{},[11,1351,1352,1353,83],{},"The three options appear in Adjust Last Operation after the run. The panel itself shows ",[20,1354,1355],{},"Select 2+ meshes, the active one stays",[11,1357,1358,1359,1362,1363,33,1365,1368],{},"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 ",[20,1360,1361],{},"_union"," at the end). The other objects are hidden, and ",[15,1364,346],{},[20,1366,1367],{},"Alt+H",") brings them back.",[11,1370,1023,1371,1374,1375,1378],{},[20,1372,1373],{},"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 ",[20,1376,1377],{},"N left as plain boolean"," and the message is a warning.",[11,1380,1381],{},"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.",[39,1383,1385],{"id":1384},"where-to-go-next","Where to go next",[369,1387,1388,1393,1398],{},[50,1389,1390,1391,83],{},"Step-by-step use of these tools: ",[25,1392,813],{"href":409},[50,1394,1395,1396,83],{},"Something refused or looked wrong: ",[25,1397,175],{"href":174},[50,1399,1400,1401,83],{},"Overview and price: ",[25,1402,430],{"href":376},[39,1404,367],{"id":366},[369,1406,1407,1411,1415],{},[50,1408,373,1409],{},[25,1410,17],{"href":376},[50,1412,1413],{},[25,1414,381],{"href":174},[50,1416,384,1417,387,1419,290,1421],{},[25,1418,113],{"href":112},[25,1420,304],{"href":303},[25,1422,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":1424},[1425,1426,1427,1428,1429,1430,1431,1432,1433,1434],{"id":861,"depth":395,"text":862},{"id":907,"depth":395,"text":72},{"id":940,"depth":395,"text":62},{"id":973,"depth":395,"text":974},{"id":1043,"depth":395,"text":1044},{"id":1133,"depth":395,"text":1134},{"id":1212,"depth":395,"text":1213},{"id":1297,"depth":395,"text":322},{"id":1384,"depth":395,"text":1385},{"id":366,"depth":395,"text":367},"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.",{},3,"---\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":856,"description":1435},"docs\u002Fquadfix\u002Fpanel","Tf8eiqn-ALmSnySIKrsT520o6c231qEdFmf767Owd2Y",{"id":4,"title":5,"addon":6,"body":1443,"description":404,"extension":405,"meta":1686,"navigation":407,"order":408,"path":409,"rawbody":410,"seo":1687,"stem":412,"updated":413,"__hash__":414},{"type":8,"value":1444,"toc":1677},[1445,1457,1459,1461,1487,1491,1495,1501,1503,1505,1535,1539,1541,1543,1571,1575,1579,1583,1585,1587,1615,1621,1623,1625,1649,1651,1653,1657,1659],[11,1446,13,1447,18,1449,23,1451,29,1453,33,1455,37],{},[15,1448,17],{},[20,1450,22],{},[25,1452,28],{"href":27},[20,1454,32],{},[20,1456,36],{},[39,1458,42],{"id":41},[11,1460,45],{},[47,1462,1463,1467,1471,1473,1479,1483],{},[50,1464,52,1465,56],{},[20,1466,55],{},[50,1468,59,1469,63],{},[15,1470,62],{},[50,1472,66],{},[50,1474,69,1475,73,1477,77],{},[15,1476,72],{},[15,1478,76],{},[50,1480,59,1481,83],{},[15,1482,82],{},[50,1484,86,1485,83],{},[20,1486,89],{},[11,1488,1489],{},[93,1490],{"alt":95,"src":96},[11,1492,1493],{},[93,1494],{"alt":101,"src":102},[11,1496,105,1497,109,1499,83],{},[15,1498,108],{},[25,1500,113],{"href":112},[39,1502,117],{"id":116},[11,1504,120],{},[47,1506,1507,1513,1519,1521,1525,1533],{},[50,1508,59,1509,127,1511,131],{},[20,1510,55],{},[20,1512,130],{},[50,1514,134,1515,138,1517,142],{},[20,1516,137],{},[20,1518,141],{},[50,1520,145],{},[50,1522,59,1523,83],{},[15,1524,150],{},[50,1526,153,1527,157,1529,161,1531,165],{},[15,1528,156],{},[15,1530,160],{},[15,1532,164],{},[50,1534,168],{},[11,1536,171,1537,83],{},[25,1538,175],{"href":174},[39,1540,179],{"id":178},[11,1542,182],{},[47,1544,1545,1547,1553,1557,1561,1565,1569],{},[50,1546,187],{},[50,1548,59,1549,192,1551,195],{},[20,1550,55],{},[15,1552,62],{},[50,1554,198,1555,202],{},[20,1556,201],{},[50,1558,205,1559,209],{},[15,1560,208],{},[50,1562,69,1563,215],{},[15,1564,214],{},[50,1566,59,1567,83],{},[15,1568,220],{},[50,1570,223],{},[11,1572,1573],{},[93,1574],{"alt":228,"src":229},[11,1576,1577],{},[93,1578],{"alt":234,"src":235},[11,1580,238,1581,243],{},[25,1582,242],{"href":241},[39,1584,247],{"id":246},[11,1586,250],{},[47,1588,1589,1593,1597,1601,1605],{},[50,1590,255,1591,258],{},[15,1592,62],{},[50,1594,261,1595,83],{},[20,1596,201],{},[50,1598,266,1599,270],{},[15,1600,269],{},[50,1602,59,1603,83],{},[15,1604,275],{},[50,1606,278,1607,282,1609,286,1611,290,1613,294],{},[20,1608,281],{},[15,1610,285],{},[15,1612,289],{},[15,1614,293],{},[11,1616,297,1617,300,1619,83],{},[15,1618,62],{},[25,1620,304],{"href":303},[39,1622,308],{"id":307},[11,1624,311],{},[47,1626,1627,1629,1635,1641,1643],{},[50,1628,316],{},[50,1630,319,1631,323,1633,83],{},[15,1632,322],{},[15,1634,326],{},[50,1636,329,1637,333,1639,337],{},[15,1638,332],{},[15,1640,336],{},[50,1642,340],{},[50,1644,343,1645,347,1647,351],{},[15,1646,346],{},[15,1648,350],{},[11,1650,354],{},[39,1652,358],{"id":357},[11,1654,59,1655,363],{},[15,1656,62],{},[39,1658,367],{"id":366},[369,1660,1661,1665,1669],{},[50,1662,373,1663],{},[25,1664,17],{"href":376},[50,1666,1667],{},[25,1668,381],{"href":174},[50,1670,384,1671,387,1673,290,1675],{},[25,1672,113],{"href":112},[25,1674,304],{"href":303},[25,1676,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":1678},[1679,1680,1681,1682,1683,1684,1685],{"id":41,"depth":395,"text":42},{"id":116,"depth":395,"text":117},{"id":178,"depth":395,"text":179},{"id":246,"depth":395,"text":247},{"id":307,"depth":395,"text":308},{"id":357,"depth":395,"text":358},{"id":366,"depth":395,"text":367},{},{"title":5,"description":404},{"id":1689,"title":1690,"addon":6,"body":1691,"description":2059,"extension":405,"meta":2060,"navigation":407,"order":2061,"path":174,"rawbody":2062,"seo":2063,"stem":2064,"updated":413,"__hash__":2065},"docs\u002Fdocs\u002Fquadfix\u002Ftroubleshooting.md","QuadFix troubleshooting: errors and fixes",{"type":8,"value":1692,"toc":2028},[1693,1698,1702,1708,1712,1724,1728,1745,1749,1756,1760,1763,1767,1773,1777,1783,1787,1790,1794,1799,1803,1806,1810,1813,1817,1820,1824,1827,1831,1834,1838,1845,1849,1859,1863,1878,1882,1885,1889,1898,1902,1913,1917,1926,1930,1935,1939,1942,1946,1952,1956,1968,1972,1975,1979,1991,1995,2008,2010],[11,1694,1695,1696,83],{},"Messages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the ",[25,1697,28],{"href":27},[39,1699,1701],{"id":1700},"why-are-the-quadfix-buttons-greyed-out","Why are the QuadFix buttons greyed out?",[11,1703,1704,1705,1707],{},"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 ",[20,1706,55],{},". 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.",[39,1709,1711],{"id":1710},"why-does-fill-holes-say-no-boundary-edges-holes-in-selection","Why does Fill Holes say \"No boundary edges (holes) in selection\"?",[11,1713,1714,1715,1717,1718,1720,1721,1723],{},"Fill Holes with ",[15,1716,72],{}," on looks for open edges in your selection. Either nothing selected is a boundary edge, or the mesh has no holes. Press ",[15,1719,62],{}," to select the open edges, then press ",[15,1722,82],{},". A mesh without any open edge, such as a closed sphere, has no holes.",[39,1725,1727],{"id":1726},"why-does-fill-holes-say-nothing-to-fill","Why does Fill Holes say \"Nothing to fill\"?",[11,1729,1730,1731,1734,1735,1738,1739,1741,1742,1744],{},"The message lists the reasons. ",[20,1732,1733],{},"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. ",[20,1736,1737],{},"partly selected hole(s)"," means only some edges of a hole loop are selected. Select the full loop, or turn ",[15,1740,72],{}," off to consider the whole mesh. Select by edge loop with ",[20,1743,137],{}," and click on one edge of the hole.",[39,1746,1748],{"id":1747},"why-was-one-of-my-holes-skipped","Why was one of my holes skipped?",[11,1750,1751,1752,1755],{},"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 ",[20,1753,1754],{},"1 partly selected hole(s) skipped",". Fix the selection and run the tool again.",[39,1757,1759],{"id":1758},"why-did-fill-holes-close-an-opening-i-wanted-open","Why did Fill Holes close an opening I wanted open?",[11,1761,1762],{},"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.",[39,1764,1766],{"id":1765},"why-does-the-patch-have-triangles-instead-of-quads","Why does the patch have triangles instead of quads?",[11,1768,1769,1770,1772],{},"If at least 70 percent of the faces around the patch are triangles, ",[15,1771,108],{}," 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.",[39,1774,1776],{"id":1775},"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)\"?",[11,1778,1779,1780,1782],{},"Nothing usable is selected. Switch to Edge select mode with ",[20,1781,130],{},", 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.",[39,1784,1786],{"id":1785},"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\"?",[11,1788,1789],{},"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.",[39,1791,1793],{"id":1792},"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\"?",[11,1795,1796,1797,83],{},"It needs exactly two sides. A single hole is closed with ",[15,1798,82],{},[39,1800,1802],{"id":1801},"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\"?",[11,1804,1805],{},"More than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.",[39,1807,1809],{"id":1808},"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?",[11,1811,1812],{},"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.",[39,1814,1816],{"id":1815},"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\"?",[11,1818,1819],{},"Both sides must be the same kind: two closed loops or two open chains. Select a matching pair.",[39,1821,1823],{"id":1822},"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?",[11,1825,1826],{},"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.",[39,1828,1830],{"id":1829},"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\"?",[11,1832,1833],{},"A closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.",[39,1835,1837],{"id":1836},"why-does-bridge-to-quads-say-the-two-sides-face-opposite-ways","Why does Bridge to Quads say the two sides face opposite ways?",[11,1839,1840,1841,1844],{},"The faces beside the two loops have normals that point in opposite directions. Use ",[15,1842,1843],{},"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.",[39,1846,1848],{"id":1847},"why-does-bridge-to-quads-say-a-loop-has-no-length","Why does Bridge to Quads say a loop \"has no length\"?",[11,1850,1851,1852,1855,1856,1858],{},"The vertices of a selected loop sit on top of each other. Run ",[15,1853,1854],{},"Mesh > Clean Up > Merge by Distance",", or ",[15,1857,760],{},", then select the loops again.",[39,1860,1862],{"id":1861},"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\"?",[11,1864,1865,1866,1868,1869,1871,1872,1874,1875,1877],{},"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 ",[15,1867,160],{}," value with ",[15,1870,156],{}," off, set ",[15,1873,164],{}," to 0, or choose loops that are less tilted against each other. A closed loop of three edges is better closed with ",[15,1876,82],{},". 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.",[39,1879,1881],{"id":1880},"why-does-the-bridge-leave-one-triangle","Why does the bridge leave one triangle?",[11,1883,1884],{},"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.",[39,1886,1888],{"id":1887},"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)\"?",[11,1890,1891,1892,1894,1895,1897],{},"Everything in the selection is already a quad, or is a flat n-gon protected by ",[15,1893,269],{},". Switch that option off to convert flat n-gons as well. Check that ",[15,1896,72],{}," is not hiding the faces you want to process.",[39,1899,1901],{"id":1900},"why-do-triangles-remain-after-n-gons-to-quads-or-clean-quad","Why do triangles remain after N-gons to Quads or Clean & Quad?",[11,1903,1904,1905,290,1907,1909,1910,1912],{},"Two triangles are joined only when the angles are within ",[15,1906,289],{},[15,1908,293],{},". Triangles with no suitable neighbour stay. Raise the angles or switch on ",[15,1911,285],{},", 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.",[39,1914,1916],{"id":1915},"why-did-clean-quad-leave-some-n-gons-or-triangles-alone","Why did Clean & Quad leave some n-gons or triangles alone?",[11,1918,1919,1920,1922,1923,1925],{},"Flat n-gons that were in the mesh before the run stay when ",[15,1921,269],{}," 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 ",[15,1924,214],{}," is on.",[39,1927,1929],{"id":1928},"why-did-clean-quad-change-nothing-near-my-corners","Why did Clean & Quad change nothing near my corners?",[11,1931,1932,1933,83],{},"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 ",[15,1934,1251],{},[39,1936,1938],{"id":1937},"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\"?",[11,1940,1941],{},"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.",[39,1943,1945],{"id":1944},"why-does-union-to-quads-say-boolean-union-produced-no-faces","Why does Union to Quads say \"Boolean union produced no faces\"?",[11,1947,1948,1949,1951],{},"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 ",[15,1950,62],{}," on each object to check for open boundary edges, and fill the holes first.",[39,1953,1955],{"id":1954},"why-does-union-to-quads-report-left-as-plain-boolean","Why does Union to Quads report \"left as plain boolean\"?",[11,1957,1958,1959,1961,1962,1964,1965,1967],{},"Some seams were not rebuilt cleanly. The result of such a seam would have changed the surface by more than ",[15,1960,336],{},", 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 ",[15,1963,332],{}," value instead of Auto, or raise ",[15,1966,336],{}," a little. Fill holes in the inputs before the union.",[39,1969,1971],{"id":1970},"why-is-the-union-to-quads-seam-a-zig-zag","Why is the Union to Quads seam a zig-zag?",[11,1973,1974],{},"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.",[39,1976,1978],{"id":1977},"where-did-the-other-objects-go-after-union-to-quads","Where did the other objects go after Union to Quads?",[11,1980,1981,1982,1984,1985,1987,1988,1990],{},"They are hidden. Use ",[15,1983,346],{},". With ",[15,1986,350],{}," off they are deleted, so ",[20,1989,32],{}," is the way back.",[39,1992,1994],{"id":1993},"how-do-i-undo-a-quadfix-step","How do I undo a QuadFix step?",[11,1996,1997,1998,33,2000,2002,2003,2007],{},"Every tool is a normal Blender undo step. ",[20,1999,32],{},[20,2001,36],{}," on Mac) reverts it in one go. If you are still stuck, write to ",[25,2004,2006],{"href":2005},"mailto:support@mendboxstudio.com","support@mendboxstudio.com"," and attach a small .blend file that shows the problem.",[39,2009,367],{"id":366},[369,2011,2012,2016,2020],{},[50,2013,373,2014],{},[25,2015,17],{"href":376},[50,2017,2018],{},[25,2019,454],{"href":409},[50,2021,384,2022,387,2024,290,2026],{},[25,2023,113],{"href":112},[25,2025,304],{"href":303},[25,2027,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":2029},[2030,2031,2032,2033,2034,2035,2036,2037,2038,2039,2040,2041,2042,2043,2044,2045,2046,2047,2048,2049,2050,2051,2052,2053,2054,2055,2056,2057,2058],{"id":1700,"depth":395,"text":1701},{"id":1710,"depth":395,"text":1711},{"id":1726,"depth":395,"text":1727},{"id":1747,"depth":395,"text":1748},{"id":1758,"depth":395,"text":1759},{"id":1765,"depth":395,"text":1766},{"id":1775,"depth":395,"text":1776},{"id":1785,"depth":395,"text":1786},{"id":1792,"depth":395,"text":1793},{"id":1801,"depth":395,"text":1802},{"id":1808,"depth":395,"text":1809},{"id":1815,"depth":395,"text":1816},{"id":1822,"depth":395,"text":1823},{"id":1829,"depth":395,"text":1830},{"id":1836,"depth":395,"text":1837},{"id":1847,"depth":395,"text":1848},{"id":1861,"depth":395,"text":1862},{"id":1880,"depth":395,"text":1881},{"id":1887,"depth":395,"text":1888},{"id":1900,"depth":395,"text":1901},{"id":1915,"depth":395,"text":1916},{"id":1928,"depth":395,"text":1929},{"id":1937,"depth":395,"text":1938},{"id":1944,"depth":395,"text":1945},{"id":1954,"depth":395,"text":1955},{"id":1970,"depth":395,"text":1971},{"id":1977,"depth":395,"text":1978},{"id":1993,"depth":395,"text":1994},{"id":366,"depth":395,"text":367},"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":1690,"description":2059},"docs\u002Fquadfix\u002Ftroubleshooting","CQNvvl5eI4l8O7afth99gPDfciv-efcqlJ5wU1xIYP8",{"id":2067,"title":2068,"addon":6,"body":2069,"description":2331,"extension":405,"meta":2332,"navigation":407,"order":2333,"path":465,"rawbody":2334,"seo":2335,"stem":2336,"updated":413,"__hash__":2337},"docs\u002Fdocs\u002Fquadfix\u002Fchangelog.md","QuadFix changelog",{"type":8,"value":2070,"toc":2310},[2071,2081,2085,2096,2100,2111,2115,2120,2124,2129,2133,2138,2142,2147,2151,2156,2160,2165,2169,2174,2178,2183,2187,2192,2196,2201,2205,2210,2214,2219,2223,2228,2232,2239,2243,2272,2276,2290,2292],[11,2072,2073,2074,2076,2077,2080],{},"Current version: 1.4.5. Updates for the 1.x line are free. Every date is in 2026. See the ",[25,2075,817],{"href":376}," for the current feature list and ",[25,2078,2079],{"href":441},"install"," for how to update.",[39,2082,2084],{"id":2083},"_145-9-november-2026","1.4.5 (9 November 2026)",[369,2086,2087,2093],{},[50,2088,2089,2090,2092],{},"Bridge to Quads: ",[15,2091,164],{}," now continues the surface walls on either side instead of fairing the strip.",[50,2094,2095],{},"Bridge to Quads: the angle smoothing stays inside its own row and no longer depends on object scale.",[39,2097,2099],{"id":2098},"_144-9-november-2026","1.4.4 (9 November 2026)",[369,2101,2102,2108],{},[50,2103,2104,2105,2107],{},"New tool: ",[15,2106,150],{},". 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.",[50,2109,2110],{},"The strip is more even around the reductions, and reduction rows are spread out.",[39,2112,2114],{"id":2113},"_143-8-november-2026","1.4.3 (8 November 2026)",[369,2116,2117],{},[50,2118,2119],{},"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.",[39,2121,2123],{"id":2122},"_142-8-november-2026","1.4.2 (8 November 2026)",[369,2125,2126],{},[50,2127,2128],{},"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.",[39,2130,2132],{"id":2131},"_141-8-november-2026","1.4.1 (8 November 2026)",[369,2134,2135],{},[50,2136,2137],{},"Fill Holes splits notched, grid-shaped holes into rectangles and grid-fills each one.",[39,2139,2141],{"id":2140},"_140-8-november-2026","1.4.0 (8 November 2026)",[369,2143,2144],{},[50,2145,2146],{},"Union to Quads: a reduction row behind dense loops, and staircase teeth are kept.",[39,2148,2150],{"id":2149},"_135-8-november-2026","1.3.5 (8 November 2026)",[369,2152,2153],{},[50,2154,2155],{},"Union to Quads: back to the narrow seam strip with a lower cost for extra rings.",[39,2157,2159],{"id":2158},"_134-8-november-2026","1.3.4 (8 November 2026)",[369,2161,2162],{},[50,2163,2164],{},"Union to Quads: wider strips are preferred in seam crevices.",[39,2166,2168],{"id":2167},"_133-7-november-2026","1.3.3 (7 November 2026)",[369,2170,2171],{},[50,2172,2173],{},"Union to Quads keeps body creases sharp through the seam strip.",[39,2175,2177],{"id":2176},"_132-7-november-2026","1.3.2 (7 November 2026)",[369,2179,2180],{},[50,2181,2182],{},"Union to Quads absorbs differences in vertex count between the two sides with quad reductions.",[39,2184,2186],{"id":2185},"_131-31-october-2026","1.3.1 (31 October 2026)",[369,2188,2189],{},[50,2190,2191],{},"Union to Quads smooths the boundary loops of the strip along the seam.",[39,2193,2195],{"id":2194},"_130-7-october-2026","1.3.0 (7 October 2026)",[369,2197,2198],{},[50,2199,2200],{},"Union to Quads matches the two sides of the seam strip by arc length, giving fewer triangles and spikes.",[39,2202,2204],{"id":2203},"_126-125-and-124-5-october-2026","1.2.6, 1.2.5 and 1.2.4 (5 October 2026)",[369,2206,2207],{},[50,2208,2209],{},"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.",[39,2211,2213],{"id":2212},"_123-5-october-2026","1.2.3 (5 October 2026)",[369,2215,2216],{},[50,2217,2218],{},"All tools are visible in both Object Mode and Edit Mode and are greyed out when the mode does not fit.",[39,2220,2222],{"id":2221},"_122-5-october-2026","1.2.2 (5 October 2026)",[369,2224,2225],{},[50,2226,2227],{},"Union to Quads rejects folded strips and prefers narrower, less sliver-like results when Rings is Auto.",[39,2229,2231],{"id":2230},"_120-october-2026","1.2.0 (October 2026)",[369,2233,2234],{},[50,2235,2104,2236,2238],{},[15,2237,326],{},". An exact Boolean union whose seam is rebuilt as a strip of quads, with Rings, Max Shape Change % and Keep Originals Hidden options.",[39,2240,2242],{"id":2241},"_118-to-110-27-and-28-september-2026","1.1.8 to 1.1.0 (27 and 28 September 2026)",[369,2244,2245,2248,2251,2254,2257,2260,2263,2266,2269],{},[50,2246,2247],{},"1.1.8: hole patches are faired smoothly onto the surface.",[50,2249,2250],{},"1.1.7: an automatic test suite on Blender 4.2, 4.5 and 5.2, and the fixes it found.",[50,2252,2253],{},"1.1.6: Clean & Quad converts faces created by its own dissolve in Face select mode.",[50,2255,2256],{},"1.1.5: wire edges left behind when a failed fill is reverted are removed.",[50,2258,2259],{},"1.1.4: round holes on curved surfaces are rebuilt properly.",[50,2261,2262],{},"1.1.3: Clean & Quad converts n-gons created by its own dissolve regardless of Keep Planar N-gons. Fill Holes matches triangle neighbourhoods.",[50,2264,2265],{},"1.1.2: grid growth works for all closed loops, and folded results are detected and reverted.",[50,2267,2268],{},"1.1.1: new vertices are relaxed onto the surface so patches bulge like their surroundings.",[50,2270,2271],{},"1.1.0: band-shaped holes are rebuilt by growing a quad grid across the gap.",[39,2273,2275],{"id":2274},"_109-to-100-27-september-2026","1.0.9 to 1.0.0 (27 September 2026)",[369,2277,2278,2281,2284,2287],{},[50,2279,2280],{},"1.0.9: grid rows follow the grid around the hole, and each piece of a split hole is filled separately.",[50,2282,2283],{},"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.",[50,2285,2286],{},"1.0.2: the version label appears in the panel.",[50,2288,2289],{},"1.0.0: first release with Fill Holes with Quads, N-gons to Quads and Clean & Quad.",[39,2291,367],{"id":366},[369,2293,2294,2298,2302],{},[50,2295,373,2296],{},[25,2297,17],{"href":376},[50,2299,2300],{},[25,2301,381],{"href":174},[50,2303,384,2304,387,2306,290,2308],{},[25,2305,113],{"href":112},[25,2307,304],{"href":303},[25,2309,392],{"href":241},{"title":394,"searchDepth":395,"depth":395,"links":2311},[2312,2313,2314,2315,2316,2317,2318,2319,2320,2321,2322,2323,2324,2325,2326,2327,2328,2329,2330],{"id":2083,"depth":395,"text":2084},{"id":2098,"depth":395,"text":2099},{"id":2113,"depth":395,"text":2114},{"id":2122,"depth":395,"text":2123},{"id":2131,"depth":395,"text":2132},{"id":2140,"depth":395,"text":2141},{"id":2149,"depth":395,"text":2150},{"id":2158,"depth":395,"text":2159},{"id":2167,"depth":395,"text":2168},{"id":2176,"depth":395,"text":2177},{"id":2185,"depth":395,"text":2186},{"id":2194,"depth":395,"text":2195},{"id":2203,"depth":395,"text":2204},{"id":2212,"depth":395,"text":2213},{"id":2221,"depth":395,"text":2222},{"id":2230,"depth":395,"text":2231},{"id":2241,"depth":395,"text":2242},{"id":2274,"depth":395,"text":2275},{"id":366,"depth":395,"text":367},"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":2068,"description":2331},"docs\u002Fquadfix\u002Fchangelog","7arTMmN_Ib84b8873BVyFy7WGCCp5DrTO8K_LA5M6K4",{"id":2339,"title":2340,"blender":2341,"body":2342,"buy":2537,"description":2544,"extension":405,"lite":2545,"meta":2547,"name":17,"navigation":407,"path":376,"poster":2548,"price":2549,"problem":2550,"rawbody":2551,"seo":2552,"status":2553,"stem":2554,"updated":413,"version":2555,"video":2556,"__hash__":2557},"addons\u002Faddons\u002Fquadfix.md","QuadFix: Blender quad fill & cleanup add-on","4.2 and newer",{"type":8,"value":2343,"toc":2528},[2344,2348,2351,2354,2358,2364,2396,2405,2411,2417,2421,2424,2438,2444,2446,2453,2455,2472,2476,2490,2494,2514],[39,2345,2347],{"id":2346},"the-problem","The problem",[11,2349,2350],{},"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.",[11,2352,2353],{},"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.",[39,2355,2357],{"id":2356},"what-quadfix-does","What QuadFix does",[11,2359,2360,2361,2363],{},"The tools live in the ",[15,2362,17],{}," tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.",[369,2365,2366,2371,2376,2381,2386,2391],{},[50,2367,2368,2370],{},[15,2369,82],{}," 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.",[50,2372,2373,2375],{},[15,2374,150],{}," 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.",[50,2377,2378,2380],{},[15,2379,275],{}," 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.",[50,2382,2383,2385],{},[15,2384,220],{}," 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.",[50,2387,2388,2390],{},[15,2389,62],{}," selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.",[50,2392,2393,2395],{},[15,2394,326],{}," 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.",[11,2397,2398,2399,2401,2402,83],{},"Every option is described in the ",[25,2400,28],{"href":27},". Step-by-step recipes are in the ",[25,2403,2404],{"href":409},"workflows page",[11,2406,2407],{},[93,2408],{"alt":2409,"src":2410},"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",[11,2412,2413],{},[93,2414],{"alt":2415,"src":2416},"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",[39,2418,2420],{"id":2419},"what-it-does-not-do","What it does not do",[11,2422,2423],{},"QuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.",[369,2425,2426,2429,2432,2435],{},[50,2427,2428],{},"Very irregular scans keep some triangles. The result line in the panel tells you how many remain.",[50,2430,2431],{},"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.",[50,2433,2434],{},"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.",[50,2436,2437],{},"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.",[11,2439,238,2440,2443],{},[25,2441,2442],{"href":174},"troubleshooting page"," lists the messages you can see and what to do about each.",[39,2445,589],{"id":588},[11,2447,2448,2449,2452],{},"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 ",[25,2450,2451],{"href":441},"how to install QuadFix",". The licence is GPL-3.0-or-later.",[39,2454,515],{"id":514},[369,2456,2457,2462,2467],{},[50,2458,2459,2461],{},[25,2460,525],{"href":112},": the manual way first, then the one-click way.",[50,2463,2464,2466],{},[25,2465,530],{"href":303}," and decide which n-gons to leave alone.",[50,2468,2469,2471],{},[25,2470,535],{"href":241}," before you sculpt, UV or print it.",[39,2473,2475],{"id":2474},"free-quadfix-lite","Free QuadFix Lite",[11,2477,2478,2479,2483,2484,2486,2487,83],{},"QuadFix Lite is a free, open-source cut of the add-on, available on ",[25,2480,2482],{"href":709,"rel":2481},[608],"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 ",[15,2485,711],{},", so it can sit next to the full version. A side-by-side table is on the ",[25,2488,2489],{"href":441},"install page",[39,2491,2493],{"id":2492},"how-to-buy","How to buy",[11,2495,2496,2497,2501,2502,2506,2507,2509,2510,131],{},"QuadFix costs $12. You can get it on ",[25,2498,609],{"href":2499,"rel":2500},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[608]," or on ",[25,2503,615],{"href":2504,"rel":2505},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[608],". Both give you the same .zip. Free updates are included for the 1.x line. Questions go to ",[25,2508,2006],{"href":2005},". Built and tested by Pavel at Mendbox Studio (",[25,2511,2513],{"href":2512},"\u002Fabout","about",[11,2515,2516,2517,2520,2521,2524,2525,2527],{},"After purchase, follow the ",[25,2518,2519],{"href":441},"install steps",", then open the ",[25,2522,2523],{"href":576},"documentation overview",". The ",[25,2526,689],{"href":465}," lists every version.",{"title":394,"searchDepth":395,"depth":395,"links":2529},[2530,2531,2532,2533,2534,2535,2536],{"id":2346,"depth":395,"text":2347},{"id":2356,"depth":395,"text":2357},{"id":2419,"depth":395,"text":2420},{"id":588,"depth":395,"text":589},{"id":514,"depth":395,"text":515},{"id":2474,"depth":395,"text":2475},{"id":2492,"depth":395,"text":2493},[2538,2541],{"label":2539,"to":2540},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix",{"label":2542,"to":2543},"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.",{"summary":2546,"to":709},"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.",{},"\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":2340,"description":2544},"released","addons\u002Fquadfix","1.4.5","\u002Fmedia\u002Fquadfix.mp4","amZYvMitLwbhp1ca_RA8Ya1NuxulM6mN0AUqALtM3qg",1794858941686]