[{"data":1,"prerenderedAt":845},["ShallowReactive",2],{"\u002Fguides\u002Fclean-up-imported-stl":3,"\u002Fguides\u002Fclean-up-imported-stl-addon":603},{"id":4,"title":5,"addon":6,"body":7,"description":591,"extension":592,"meta":593,"navigation":594,"path":595,"poster":596,"rawbody":597,"seo":598,"stem":599,"updated":600,"video":601,"__hash__":602},"guides\u002Fguides\u002Fclean-up-imported-stl.md","Clean up an imported STL or OBJ in Blender","quadfix",{"type":8,"value":9,"toc":575},"minimark",[10,31,34,39,62,78,82,105,108,124,127,131,149,158,162,180,193,197,239,242,245,249,252,277,290,294,305,325,329,349,353,449,453,484,488,499,529,543,560,564],[11,12,13,14,18,19,22,23,26,27,30],"p",{},"To clean up an imported STL or OBJ mesh in Blender, work in this order in Edit Mode: ",[15,16,17],"strong",{},"Merge by Distance"," to weld split vertices, ",[15,20,21],{},"Delete Loose"," to remove stray geometry, ",[15,24,25],{},"Recalculate Normals"," to fix inside-out faces, ",[15,28,29],{},"Select Non Manifold"," to find the holes, then fill them and simplify the triangles. Each step is a menu entry, and the order matters because the later steps depend on the mesh being welded.",[11,32,33],{},"I ran everything here on test meshes in Blender 4.2.23 and 5.2.2, and the numbers come from those runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.",[35,36,38],"h2",{"id":37},"step-1-import-the-file","Step 1: import the file",[11,40,41,42,45,46,49,50,53,54,57,58,61],{},"Choose ",[15,43,44],{},"File > Import > STL (.stl)",", or ",[15,47,48],{},"File > Import > Wavefront (.obj)"," for an OBJ. In Blender 4.2 and later the STL importer is built in, there is nothing to enable. Its options include ",[15,51,52],{},"Scale",", ",[15,55,56],{},"Scene Unit",", the forward and up axes, and ",[15,59,60],{},"Validate Mesh",". If the model arrives far too large or small, change the Scale option.",[11,63,64,65,69,70,73,74,77],{},"Then select the object, press ",[66,67,68],"code",{},"Tab",", and press ",[66,71,72],{},"A"," to select everything. Turn on ",[15,75,76],{},"Overlays > Statistics"," so you can watch the vertex, edge and face counts change.",[35,79,81],{"id":80},"step-2-merge-by-distance-m-by-distance","Step 2: Merge by Distance (M > By Distance)",[11,83,84,85,88,89,92,93,96,97,100,101,104],{},"Press ",[66,86,87],{},"M"," in Edit Mode and choose ",[15,90,91],{},"By Distance",", or use ",[15,94,95],{},"Mesh > Merge > By Distance",". The same operator is also in ",[15,98,99],{},"Mesh > Clean Up"," under the name Merge by Distance. It welds vertices that are closer together than ",[15,102,103],{},"Merge Distance"," (0.0001 by default).",[11,106,107],{},"What it does depends on the file:",[109,110,111,115,121],"ul",{},[112,113,114],"li",{},"A clean STL may need nothing. In my test, Blender's importer already welded vertices that sit at exactly the same position: 503 triangles arrived as 260 vertices, and Merge by Distance removed 0.",[112,116,117,118,120],{},"A file whose triangles do not share exact positions arrives unwelded. I nudged every vertex of a test mesh by up to 0.0005 before exporting it. After import it had 1509 vertices (three per triangle) and every edge counted as open. Merge by Distance at the default 0.0001 removed only 14 vertices. Raising ",[15,119,103],{}," to 0.002 in the Adjust Last Operation panel removed 1235 and left 260 vertices, with only the real hole still open.",[112,122,123],{},"The distance is measured in the object's own units, before object scale. In my test, two vertices 0.001 apart on an object scaled 100 times were merged with a Merge Distance of 0.01.",[11,125,126],{},"Raise the value in small steps. Too large a distance will collapse small details together.",[35,128,130],{"id":129},"step-3-delete-loose-mesh-clean-up-delete-loose","Step 3: Delete Loose (Mesh > Clean Up > Delete Loose)",[11,132,133,134,137,138,53,141,144,145,148],{},"Scans and CAD exports often carry stray vertices and edges. ",[15,135,136],{},"Mesh > Clean Up > Delete Loose"," removes them, with the options ",[15,139,140],{},"Vertices",[15,142,143],{},"Edges"," and ",[15,146,147],{},"Faces",". In my test, 3 stray vertices and 1 stray edge added to the mesh were removed, and nothing else changed.",[11,150,151,152,154,155,157],{},"A floating triangle that is not connected to the model is not loose in this sense. With ",[15,153,147],{}," off, nothing was removed. With ",[15,156,147],{}," on, the triangle and its vertices were deleted. Turn Faces on only if you are sure those pieces are junk, since a separate shell can also be a real part.",[35,159,161],{"id":160},"step-4-recalculate-normals-shiftn","Step 4: Recalculate Normals (Shift+N)",[11,163,164,165,168,169,172,173,175,176,179],{},"Open ",[15,166,167],{},"Mesh > Normals > Recalculate Outside"," or press ",[66,170,171],{},"Shift+N",". Select the whole mesh first. In my test, I flipped the top faces of a closed 503-face mesh, so only 292 faces pointed outward. After ",[66,174,171],{},", all 503 did. Use ",[15,177,178],{},"Recalculate Inside"," only for a mesh you want to see from the inside.",[11,181,182,183,185,186,188,189,192],{},"Recalculating only works on welded faces, which is why Step 2 comes first. I tested it on an unwelded triangulated sphere, where every face had its own vertices, with the top faces flipped: 312 of 528 faces pointed outward before ",[66,184,171],{}," and 259 after, so it fixed nothing. After Merge by Distance, ",[66,187,171],{}," made all 528 point outward. Turn on ",[15,190,191],{},"Overlays > Face Orientation"," to check: blue faces point outward, red faces point inward.",[35,194,196],{"id":195},"step-5-find-the-holes-with-select-non-manifold","Step 5: find the holes with Select Non Manifold",[198,199,200,210,220],"ol",{},[112,201,84,202,205,206,209],{},[66,203,204],{},"1"," for vertex select mode or ",[66,207,208],{},"2"," for edge select mode.",[112,211,41,212,215,216,219],{},[15,213,214],{},"Select > Select All by Trait > Non Manifold",", or press ",[66,217,218],{},"Shift+Ctrl+Alt+M",".",[112,221,222,223,226,227,53,230,53,233,53,236,238],{},"In the Adjust Last Operation panel, keep ",[15,224,225],{},"Boundaries"," ticked, which selects the edges around open holes. The other options (",[15,228,229],{},"Wire",[15,231,232],{},"Multiple Faces",[15,234,235],{},"Non Contiguous",[15,237,140],{},") find other kinds of damage.",[11,240,241],{},"In my test, a mesh with one 15-edge hole selected exactly 15 edges. On the unwelded version, every edge was selected, which is the sign that you skipped Step 2.",[11,243,244],{},"The Non Manifold entry is not available in face select mode. The menu hides it and, in my test, calling the operator in face mode failed with an error. Switch to vertex or edge mode first.",[35,246,248],{"id":247},"step-6-fill-the-holes","Step 6: fill the holes",[11,250,251],{},"You have three built-in choices.",[109,253,254,264,271],{},[112,255,256,259,260,263],{},[15,257,258],{},"Mesh > Clean Up > Fill Holes",". It only fills holes up to the ",[15,261,262],{},"Sides"," value, which defaults to 4. The 15-edge hole was not touched at the default, and with Sides set to 64 it was closed by a single 15-sided n-gon.",[112,265,266,267,270],{},"Select the hole's edges and press ",[66,268,269],{},"F",". The result is the same n-gon.",[112,272,273,276],{},[15,274,275],{},"Face > Grid Fill"," for quads, which only works on a loop with an even number of edges.",[11,278,279,280,283,284,289],{},"Selecting one edge of the hole and then using ",[15,281,282],{},"Select > Select Loops > Edge Loops"," picks the whole hole's loop. ",[285,286,288],"a",{"href":287},"\u002Fguides\u002Ffill-hole-with-quads","How to fill a hole with quads in Blender"," explains Grid Fill, Bridge Edge Loops and the odd-edge-count problem in detail.",[35,291,293],{"id":292},"step-7-simplify-with-limited-dissolve","Step 7: simplify with Limited Dissolve",[11,295,296,297,300,301,304],{},"STL files are all triangles. ",[15,298,299],{},"Mesh > Clean Up > Limited Dissolve"," merges flat neighbouring faces whose angle is below ",[15,302,303],{},"Max Angle"," (5 degrees by default). On a cube whose sides were subdivided and triangulated (192 triangles), it left 6 quads and 8 vertices. On a triangulated UV sphere (528 triangles) it produced 240 quads and 12 n-gons with 5, 6 or 7 sides in Blender 5.2.2. In 4.2.23 the same test gave 248 quads and 8 six-sided n-gons. Flat areas become clean faces, but curved areas can end up with n-gons.",[11,306,307,308,311,312,315,316,319,320,324],{},"Run ",[15,309,310],{},"Face > Tris to Quads"," (",[15,313,314],{},"Triangles to Quads"," in 5.x, ",[66,317,318],{},"Alt+J",") afterwards for the remaining triangles, and see ",[285,321,323],{"href":322},"\u002Fguides\u002Fngons-to-quads","turning n-gons and triangles into quads"," for what to do with leftover n-gons.",[35,326,328],{"id":327},"the-order-in-one-list","The order in one list",[198,330,331,334,337,340,343,346],{},[112,332,333],{},"Import the file and select everything.",[112,335,336],{},"Merge by Distance, raising the distance if the surface is still open everywhere.",[112,338,339],{},"Delete Loose.",[112,341,342],{},"Recalculate Normals.",[112,344,345],{},"Select Non Manifold, then fill the holes.",[112,347,348],{},"Limited Dissolve, then Tris to Quads.",[35,350,352],{"id":351},"methods-compared","Methods compared",[354,355,356,375],"table",{},[357,358,359],"thead",{},[360,361,362,366,369,372],"tr",{},[363,364,365],"th",{},"Problem",[363,367,368],{},"Built-in step",[363,370,371],{},"What it gives",[363,373,374],{},"Limit",[376,377,378,392,405,418,435],"tbody",{},[360,379,380,384,386,389],{},[381,382,383],"td",{},"Unwelded vertices",[381,385,17],{},[381,387,388],{},"Shared vertices",[381,390,391],{},"Distance must match the gap",[360,393,394,397,399,402],{},[381,395,396],{},"Stray vertices, edges",[381,398,21],{},[381,400,401],{},"Cleaner mesh",[381,403,404],{},"Faces option can delete real shells",[360,406,407,410,412,415],{},[381,408,409],{},"Inside-out faces",[381,411,171],{},[381,413,414],{},"Consistent normals",[381,416,417],{},"Needs connected faces",[360,419,420,423,429,432],{},[381,421,422],{},"Holes",[381,424,425,426,428],{},"Fill Holes, ",[66,427,269],{},", Grid Fill",[381,430,431],{},"N-gon, or quads on even loops",[381,433,434],{},"Fill Holes stops at Sides, Grid Fill needs even loops",[360,436,437,440,443,446],{},[381,438,439],{},"Triangle soup",[381,441,442],{},"Limited Dissolve, Alt+J",[381,444,445],{},"Quads and some n-gons",[381,447,448],{},"Curved areas keep triangles or n-gons",[35,450,452],{"id":451},"what-can-go-wrong","What can go wrong",[109,454,455,461,467,475],{},[112,456,457,460],{},[15,458,459],{},"Everything is selected as non-manifold."," The mesh is unwelded. Go back to Merge by Distance with a larger distance.",[112,462,463,466],{},[15,464,465],{},"The model collapses after merging."," The distance is too large for the model's scale.",[112,468,469,472,473,219],{},[15,470,471],{},"Shading is dark in patches."," Check Face Orientation, then run ",[66,474,171],{},[112,476,477,480,481,483],{},[15,478,479],{},"Fill Holes does nothing."," The hole has more sides than the ",[15,482,262],{}," setting.",[35,485,487],{"id":486},"faster-with-quadfix","Faster with QuadFix",[11,489,490,494,495,498],{},[285,491,493],{"href":492},"\u002Faddons\u002Fquadfix","QuadFix"," has a ",[15,496,497],{},"Clean & Quad (Boolean Prep)"," button that runs the cleanup in one go: merge doubles, remove degenerate and loose geometry, limited dissolve, tris to quads. I tested it on Blender 4.2.23 and 5.2.2.",[198,500,501,517,523],{},[112,502,84,503,505,506,508,509,512,513,516],{},[66,504,68],{},", open the ",[15,507,493],{}," tab in the sidebar (",[66,510,511],{},"N","), and press ",[15,514,515],{},"Select Non-Quads & Holes"," to see how many non-quad faces and boundary edges the mesh has.",[112,518,519,520,219],{},"Select the whole mesh and press ",[15,521,522],{},"Clean & Quad",[112,524,84,525,528],{},[15,526,527],{},"Fill Holes with Quads"," for the openings.",[11,530,531,532,534,535,538,539,542],{},"On a test mesh made of 528 separate triangles with a stray vertex (1585 vertices), Clean & Quad brought it to 266 vertices and 264 quads with no triangles left, and the report showed the before and after counts. It also recalculates normals: on a closed sphere with its top faces flipped, only 168 of 288 faces pointed outward before the button and all 288 after. ",[15,533,103],{}," (0.0001 by default), ",[15,536,537],{},"Dissolve Angle"," (5 degrees) and ",[15,540,541],{},"Keep Sharp Edges"," are on the panel.",[11,544,545,546,549,550,554,555,559],{},"Know the limits. Fill Holes keeps the patch triangular when the surrounding mesh is all triangles (",[15,547,548],{},"Match Triangle Meshes",", on by default). On a fully triangulated mesh with a 15-edge hole, the default added 23 triangles and 1 quad. With the option off the result had 13 quads and 194 triangles. It repairs the mesh you have and is not a retopology tool. The ",[285,551,553],{"href":552},"\u002Fdocs\u002Fquadfix\u002Fpanel","panel reference"," lists every option and the ",[285,556,558],{"href":557},"\u002Fdocs\u002Fquadfix\u002Fworkflows","workflows page"," shows the import cleanup flow. The free QuadFix Lite includes Clean & Quad and N-gons to Quads, but not hole filling.",[35,561,563],{"id":562},"related-guides","Related guides",[109,565,566,570],{},[112,567,568],{},[285,569,288],{"href":287},[112,571,572],{},[285,573,574],{"href":322},"How to turn n-gons and triangles into quads in Blender",{"title":576,"searchDepth":577,"depth":577,"links":578},"",2,[579,580,581,582,583,584,585,586,587,588,589,590],{"id":37,"depth":577,"text":38},{"id":80,"depth":577,"text":81},{"id":129,"depth":577,"text":130},{"id":160,"depth":577,"text":161},{"id":195,"depth":577,"text":196},{"id":247,"depth":577,"text":248},{"id":292,"depth":577,"text":293},{"id":327,"depth":577,"text":328},{"id":351,"depth":577,"text":352},{"id":451,"depth":577,"text":452},{"id":486,"depth":577,"text":487},{"id":562,"depth":577,"text":563},"Clean up an imported STL or OBJ in Blender: merge by distance, fix normals, find non-manifold edges, fill holes, delete loose geometry and dissolve triangles.","md",{},true,"\u002Fguides\u002Fclean-up-imported-stl","\u002Fmedia\u002Fquadfix.jpg","---\ntitle: \"Clean up an imported STL or OBJ in Blender\"\ndescription: \"Clean up an imported STL or OBJ in Blender: merge by distance, fix normals, find non-manifold edges, fill holes, delete loose geometry and dissolve triangles.\"\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo clean up an imported STL or OBJ mesh in Blender, work in this order in Edit Mode: **Merge by Distance** to weld split vertices, **Delete Loose** to remove stray geometry, **Recalculate Normals** to fix inside-out faces, **Select Non Manifold** to find the holes, then fill them and simplify the triangles. Each step is a menu entry, and the order matters because the later steps depend on the mesh being welded.\n\nI ran everything here on test meshes in Blender 4.2.23 and 5.2.2, and the numbers come from those runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.\n\n## Step 1: import the file\n\nChoose **File > Import > STL (.stl)**, or **File > Import > Wavefront (.obj)** for an OBJ. In Blender 4.2 and later the STL importer is built in, there is nothing to enable. Its options include **Scale**, **Scene Unit**, the forward and up axes, and **Validate Mesh**. If the model arrives far too large or small, change the Scale option.\n\nThen select the object, press `Tab`, and press `A` to select everything. Turn on **Overlays > Statistics** so you can watch the vertex, edge and face counts change.\n\n## Step 2: Merge by Distance (M > By Distance)\n\nPress `M` in Edit Mode and choose **By Distance**, or use **Mesh > Merge > By Distance**. The same operator is also in **Mesh > Clean Up** under the name Merge by Distance. It welds vertices that are closer together than **Merge Distance** (0.0001 by default).\n\nWhat it does depends on the file:\n\n- A clean STL may need nothing. In my test, Blender's importer already welded vertices that sit at exactly the same position: 503 triangles arrived as 260 vertices, and Merge by Distance removed 0.\n- A file whose triangles do not share exact positions arrives unwelded. I nudged every vertex of a test mesh by up to 0.0005 before exporting it. After import it had 1509 vertices (three per triangle) and every edge counted as open. Merge by Distance at the default 0.0001 removed only 14 vertices. Raising **Merge Distance** to 0.002 in the Adjust Last Operation panel removed 1235 and left 260 vertices, with only the real hole still open.\n- The distance is measured in the object's own units, before object scale. In my test, two vertices 0.001 apart on an object scaled 100 times were merged with a Merge Distance of 0.01.\n\nRaise the value in small steps. Too large a distance will collapse small details together.\n\n## Step 3: Delete Loose (Mesh > Clean Up > Delete Loose)\n\nScans and CAD exports often carry stray vertices and edges. **Mesh > Clean Up > Delete Loose** removes them, with the options **Vertices**, **Edges** and **Faces**. In my test, 3 stray vertices and 1 stray edge added to the mesh were removed, and nothing else changed.\n\nA floating triangle that is not connected to the model is not loose in this sense. With **Faces** off, nothing was removed. With **Faces** on, the triangle and its vertices were deleted. Turn Faces on only if you are sure those pieces are junk, since a separate shell can also be a real part.\n\n## Step 4: Recalculate Normals (Shift+N)\n\nOpen **Mesh > Normals > Recalculate Outside** or press `Shift+N`. Select the whole mesh first. In my test, I flipped the top faces of a closed 503-face mesh, so only 292 faces pointed outward. After `Shift+N`, all 503 did. Use **Recalculate Inside** only for a mesh you want to see from the inside.\n\nRecalculating only works on welded faces, which is why Step 2 comes first. I tested it on an unwelded triangulated sphere, where every face had its own vertices, with the top faces flipped: 312 of 528 faces pointed outward before `Shift+N` and 259 after, so it fixed nothing. After Merge by Distance, `Shift+N` made all 528 point outward. Turn on **Overlays > Face Orientation** to check: blue faces point outward, red faces point inward.\n\n## Step 5: find the holes with Select Non Manifold\n\n1. Press `1` for vertex select mode or `2` for edge select mode.\n2. Choose **Select > Select All by Trait > Non Manifold**, or press `Shift+Ctrl+Alt+M`.\n3. In the Adjust Last Operation panel, keep **Boundaries** ticked, which selects the edges around open holes. The other options (**Wire**, **Multiple Faces**, **Non Contiguous**, **Vertices**) find other kinds of damage.\n\nIn my test, a mesh with one 15-edge hole selected exactly 15 edges. On the unwelded version, every edge was selected, which is the sign that you skipped Step 2.\n\nThe Non Manifold entry is not available in face select mode. The menu hides it and, in my test, calling the operator in face mode failed with an error. Switch to vertex or edge mode first.\n\n## Step 6: fill the holes\n\nYou have three built-in choices.\n\n- **Mesh > Clean Up > Fill Holes**. It only fills holes up to the **Sides** value, which defaults to 4. The 15-edge hole was not touched at the default, and with Sides set to 64 it was closed by a single 15-sided n-gon.\n- Select the hole's edges and press `F`. The result is the same n-gon.\n- **Face > Grid Fill** for quads, which only works on a loop with an even number of edges.\n\nSelecting one edge of the hole and then using **Select > Select Loops > Edge Loops** picks the whole hole's loop. [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads) explains Grid Fill, Bridge Edge Loops and the odd-edge-count problem in detail.\n\n## Step 7: simplify with Limited Dissolve\n\nSTL files are all triangles. **Mesh > Clean Up > Limited Dissolve** merges flat neighbouring faces whose angle is below **Max Angle** (5 degrees by default). On a cube whose sides were subdivided and triangulated (192 triangles), it left 6 quads and 8 vertices. On a triangulated UV sphere (528 triangles) it produced 240 quads and 12 n-gons with 5, 6 or 7 sides in Blender 5.2.2. In 4.2.23 the same test gave 248 quads and 8 six-sided n-gons. Flat areas become clean faces, but curved areas can end up with n-gons.\n\nRun **Face > Tris to Quads** (**Triangles to Quads** in 5.x, `Alt+J`) afterwards for the remaining triangles, and see [turning n-gons and triangles into quads](\u002Fguides\u002Fngons-to-quads) for what to do with leftover n-gons.\n\n## The order in one list\n\n1. Import the file and select everything.\n2. Merge by Distance, raising the distance if the surface is still open everywhere.\n3. Delete Loose.\n4. Recalculate Normals.\n5. Select Non Manifold, then fill the holes.\n6. Limited Dissolve, then Tris to Quads.\n\n## Methods compared\n\n| Problem | Built-in step | What it gives | Limit |\n| --- | --- | --- | --- |\n| Unwelded vertices | Merge by Distance | Shared vertices | Distance must match the gap |\n| Stray vertices, edges | Delete Loose | Cleaner mesh | Faces option can delete real shells |\n| Inside-out faces | Shift+N | Consistent normals | Needs connected faces |\n| Holes | Fill Holes, `F`, Grid Fill | N-gon, or quads on even loops | Fill Holes stops at Sides, Grid Fill needs even loops |\n| Triangle soup | Limited Dissolve, Alt+J | Quads and some n-gons | Curved areas keep triangles or n-gons |\n\n## What can go wrong\n\n- **Everything is selected as non-manifold.** The mesh is unwelded. Go back to Merge by Distance with a larger distance.\n- **The model collapses after merging.** The distance is too large for the model's scale.\n- **Shading is dark in patches.** Check Face Orientation, then run `Shift+N`.\n- **Fill Holes does nothing.** The hole has more sides than the **Sides** setting.\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) has a **Clean & Quad (Boolean Prep)** button that runs the cleanup in one go: merge doubles, remove degenerate and loose geometry, limited dissolve, tris to quads. I tested it on Blender 4.2.23 and 5.2.2.\n\n1. Press `Tab`, open the **QuadFix** tab in the sidebar (`N`), and press **Select Non-Quads & Holes** to see how many non-quad faces and boundary edges the mesh has.\n2. Select the whole mesh and press **Clean & Quad**.\n3. Press **Fill Holes with Quads** for the openings.\n\nOn a test mesh made of 528 separate triangles with a stray vertex (1585 vertices), Clean & Quad brought it to 266 vertices and 264 quads with no triangles left, and the report showed the before and after counts. It also recalculates normals: on a closed sphere with its top faces flipped, only 168 of 288 faces pointed outward before the button and all 288 after. **Merge Distance** (0.0001 by default), **Dissolve Angle** (5 degrees) and **Keep Sharp Edges** are on the panel.\n\nKnow the limits. Fill Holes keeps the patch triangular when the surrounding mesh is all triangles (**Match Triangle Meshes**, on by default). On a fully triangulated mesh with a 15-edge hole, the default added 23 triangles and 1 quad. With the option off the result had 13 quads and 194 triangles. It repairs the mesh you have and is not a retopology tool. The [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel) lists every option and the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows) shows the import cleanup flow. The free QuadFix Lite includes Clean & Quad and N-gons to Quads, but not hole filling.\n\n## Related guides\n\n- [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads)\n- [How to turn n-gons and triangles into quads in Blender](\u002Fguides\u002Fngons-to-quads)\n",{"title":5,"description":591},"guides\u002Fclean-up-imported-stl","2026-11-16","\u002Fmedia\u002Fquadfix.mp4","LGdNC34sZ7mSiIW8f3dFZFruzcTXvAwccIxSdPQkyNo",{"id":604,"title":605,"blender":606,"body":607,"buy":826,"description":833,"extension":592,"lite":834,"meta":836,"name":493,"navigation":594,"path":492,"poster":596,"price":837,"problem":838,"rawbody":839,"seo":840,"status":841,"stem":842,"updated":600,"version":843,"video":601,"__hash__":844},"addons\u002Faddons\u002Fquadfix.md","QuadFix: Blender quad fill & cleanup add-on","4.2 and newer",{"type":8,"value":608,"toc":817},[609,613,616,619,623,629,664,672,679,685,689,692,706,714,718,726,730,750,754,771,775,800],[35,610,612],{"id":611},"the-problem","The problem",[11,614,615],{},"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,617,618],{},"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.",[35,620,622],{"id":621},"what-quadfix-does","What QuadFix does",[11,624,625,626,628],{},"The tools live in the ",[15,627,493],{}," tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.",[109,630,631,636,642,648,653,658],{},[112,632,633,635],{},[15,634,527],{}," 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.",[112,637,638,641],{},[15,639,640],{},"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.",[112,643,644,647],{},[15,645,646],{},"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.",[112,649,650,652],{},[15,651,497],{}," 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.",[112,654,655,657],{},[15,656,515],{}," selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.",[112,659,660,663],{},[15,661,662],{},"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.",[11,665,666,667,669,670,219],{},"Every option is described in the ",[285,668,553],{"href":552},". Step-by-step recipes are in the ",[285,671,558],{"href":557},[11,673,674],{},[675,676],"img",{"alt":677,"src":678},"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,680,681],{},[675,682],{"alt":683,"src":684},"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",[35,686,688],{"id":687},"what-it-does-not-do","What it does not do",[11,690,691],{},"QuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.",[109,693,694,697,700,703],{},[112,695,696],{},"Very irregular scans keep some triangles. The result line in the panel tells you how many remain.",[112,698,699],{},"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.",[112,701,702],{},"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.",[112,704,705],{},"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,707,708,709,713],{},"The ",[285,710,712],{"href":711},"\u002Fdocs\u002Fquadfix\u002Ftroubleshooting","troubleshooting page"," lists the messages you can see and what to do about each.",[35,715,717],{"id":716},"requirements","Requirements",[11,719,720,721,725],{},"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 ",[285,722,724],{"href":723},"\u002Fdocs\u002Fquadfix\u002Finstall","how to install QuadFix",". The licence is GPL-3.0-or-later.",[35,727,729],{"id":728},"guides","Guides",[109,731,732,738,744],{},[112,733,734,737],{},[285,735,736],{"href":287},"Fill a hole with quads",": the manual way first, then the one-click way.",[112,739,740,743],{},[285,741,742],{"href":322},"Convert n-gons to quads"," and decide which n-gons to leave alone.",[112,745,746,749],{},[285,747,748],{"href":595},"Clean up an imported STL"," before you sculpt, UV or print it.",[35,751,753],{"id":752},"free-quadfix-lite","Free QuadFix Lite",[11,755,756,757,763,764,767,768,219],{},"QuadFix Lite is a free, open-source cut of the add-on, available on ",[285,758,762],{"href":759,"rel":760},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite",[761],"nofollow","GitHub",". It has three tools: N-gons to Quads, Clean & Quad and Select Non-Quads & Holes, with the same options as the full version. It does not have Fill Holes with Quads, Bridge to Quads or Union to Quads, and it has no Match Triangle Meshes option. Its sidebar tab is called ",[15,765,766],{},"QuadFix Lite",", so it can sit next to the full version. A side-by-side table is on the ",[285,769,770],{"href":723},"install page",[35,772,774],{"id":773},"how-to-buy","How to buy",[11,776,777,778,783,784,789,790,794,795,799],{},"QuadFix costs $12. You can get it on ",[285,779,782],{"href":780,"rel":781},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[761],"Gumroad"," or on ",[285,785,788],{"href":786,"rel":787},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[761],"Superhive",". Both give you the same .zip. Free updates are included for the 1.x line. Questions go to ",[285,791,793],{"href":792},"mailto:support@mendboxstudio.com","support@mendboxstudio.com",". Built and tested by Pavel at Mendbox Studio (",[285,796,798],{"href":797},"\u002Fabout","about",").",[11,801,802,803,806,807,811,812,816],{},"After purchase, follow the ",[285,804,805],{"href":723},"install steps",", then open the ",[285,808,810],{"href":809},"\u002Fdocs\u002Fquadfix","documentation overview",". The ",[285,813,815],{"href":814},"\u002Fdocs\u002Fquadfix\u002Fchangelog","changelog"," lists every version.",{"title":576,"searchDepth":577,"depth":577,"links":818},[819,820,821,822,823,824,825],{"id":611,"depth":577,"text":612},{"id":621,"depth":577,"text":622},{"id":687,"depth":577,"text":688},{"id":716,"depth":577,"text":717},{"id":728,"depth":577,"text":729},{"id":752,"depth":577,"text":753},{"id":773,"depth":577,"text":774},[827,830],{"label":828,"to":829},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix",{"label":831,"to":832},"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":835,"to":759},"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.",{},"$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":605,"description":833},"released","addons\u002Fquadfix","1.4.5","amZYvMitLwbhp1ca_RA8Ya1NuxulM6mN0AUqALtM3qg",1794858941688]