[{"data":1,"prerenderedAt":3060},["ShallowReactive",2],{"home-guides":3},[4,604,1333,1833,2426],{"id":5,"title":6,"addon":7,"body":8,"description":592,"extension":593,"meta":594,"navigation":595,"path":596,"poster":597,"rawbody":598,"seo":599,"stem":600,"updated":601,"video":602,"__hash__":603},"guides\u002Fguides\u002Fclean-up-imported-stl.md","Clean up an imported STL or OBJ in Blender","quadfix",{"type":9,"value":10,"toc":576},"minimark",[11,32,35,40,63,79,83,106,109,125,128,132,150,159,163,181,194,198,240,243,246,250,253,278,291,295,306,326,330,350,354,450,454,485,489,500,530,544,561,565],[12,13,14,15,19,20,23,24,27,28,31],"p",{},"To clean up an imported STL or OBJ mesh in Blender, work in this order in Edit Mode: ",[16,17,18],"strong",{},"Merge by Distance"," to weld split vertices, ",[16,21,22],{},"Delete Loose"," to remove stray geometry, ",[16,25,26],{},"Recalculate Normals"," to fix inside-out faces, ",[16,29,30],{},"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.",[12,33,34],{},"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.",[36,37,39],"h2",{"id":38},"step-1-import-the-file","Step 1: import the file",[12,41,42,43,46,47,50,51,54,55,58,59,62],{},"Choose ",[16,44,45],{},"File > Import > STL (.stl)",", or ",[16,48,49],{},"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 ",[16,52,53],{},"Scale",", ",[16,56,57],{},"Scene Unit",", the forward and up axes, and ",[16,60,61],{},"Validate Mesh",". If the model arrives far too large or small, change the Scale option.",[12,64,65,66,70,71,74,75,78],{},"Then select the object, press ",[67,68,69],"code",{},"Tab",", and press ",[67,72,73],{},"A"," to select everything. Turn on ",[16,76,77],{},"Overlays > Statistics"," so you can watch the vertex, edge and face counts change.",[36,80,82],{"id":81},"step-2-merge-by-distance-m-by-distance","Step 2: Merge by Distance (M > By Distance)",[12,84,85,86,89,90,93,94,97,98,101,102,105],{},"Press ",[67,87,88],{},"M"," in Edit Mode and choose ",[16,91,92],{},"By Distance",", or use ",[16,95,96],{},"Mesh > Merge > By Distance",". The same operator is also in ",[16,99,100],{},"Mesh > Clean Up"," under the name Merge by Distance. It welds vertices that are closer together than ",[16,103,104],{},"Merge Distance"," (0.0001 by default).",[12,107,108],{},"What it does depends on the file:",[110,111,112,116,122],"ul",{},[113,114,115],"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.",[113,117,118,119,121],{},"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 ",[16,120,104],{}," to 0.002 in the Adjust Last Operation panel removed 1235 and left 260 vertices, with only the real hole still open.",[113,123,124],{},"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.",[12,126,127],{},"Raise the value in small steps. Too large a distance will collapse small details together.",[36,129,131],{"id":130},"step-3-delete-loose-mesh-clean-up-delete-loose","Step 3: Delete Loose (Mesh > Clean Up > Delete Loose)",[12,133,134,135,138,139,54,142,145,146,149],{},"Scans and CAD exports often carry stray vertices and edges. ",[16,136,137],{},"Mesh > Clean Up > Delete Loose"," removes them, with the options ",[16,140,141],{},"Vertices",[16,143,144],{},"Edges"," and ",[16,147,148],{},"Faces",". In my test, 3 stray vertices and 1 stray edge added to the mesh were removed, and nothing else changed.",[12,151,152,153,155,156,158],{},"A floating triangle that is not connected to the model is not loose in this sense. With ",[16,154,148],{}," off, nothing was removed. With ",[16,157,148],{}," 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.",[36,160,162],{"id":161},"step-4-recalculate-normals-shiftn","Step 4: Recalculate Normals (Shift+N)",[12,164,165,166,169,170,173,174,176,177,180],{},"Open ",[16,167,168],{},"Mesh > Normals > Recalculate Outside"," or press ",[67,171,172],{},"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 ",[67,175,172],{},", all 503 did. Use ",[16,178,179],{},"Recalculate Inside"," only for a mesh you want to see from the inside.",[12,182,183,184,186,187,189,190,193],{},"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 ",[67,185,172],{}," and 259 after, so it fixed nothing. After Merge by Distance, ",[67,188,172],{}," made all 528 point outward. Turn on ",[16,191,192],{},"Overlays > Face Orientation"," to check: blue faces point outward, red faces point inward.",[36,195,197],{"id":196},"step-5-find-the-holes-with-select-non-manifold","Step 5: find the holes with Select Non Manifold",[199,200,201,211,221],"ol",{},[113,202,85,203,206,207,210],{},[67,204,205],{},"1"," for vertex select mode or ",[67,208,209],{},"2"," for edge select mode.",[113,212,42,213,216,217,220],{},[16,214,215],{},"Select > Select All by Trait > Non Manifold",", or press ",[67,218,219],{},"Shift+Ctrl+Alt+M",".",[113,222,223,224,227,228,54,231,54,234,54,237,239],{},"In the Adjust Last Operation panel, keep ",[16,225,226],{},"Boundaries"," ticked, which selects the edges around open holes. The other options (",[16,229,230],{},"Wire",[16,232,233],{},"Multiple Faces",[16,235,236],{},"Non Contiguous",[16,238,141],{},") find other kinds of damage.",[12,241,242],{},"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.",[12,244,245],{},"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.",[36,247,249],{"id":248},"step-6-fill-the-holes","Step 6: fill the holes",[12,251,252],{},"You have three built-in choices.",[110,254,255,265,272],{},[113,256,257,260,261,264],{},[16,258,259],{},"Mesh > Clean Up > Fill Holes",". It only fills holes up to the ",[16,262,263],{},"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.",[113,266,267,268,271],{},"Select the hole's edges and press ",[67,269,270],{},"F",". The result is the same n-gon.",[113,273,274,277],{},[16,275,276],{},"Face > Grid Fill"," for quads, which only works on a loop with an even number of edges.",[12,279,280,281,284,285,290],{},"Selecting one edge of the hole and then using ",[16,282,283],{},"Select > Select Loops > Edge Loops"," picks the whole hole's loop. ",[286,287,289],"a",{"href":288},"\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.",[36,292,294],{"id":293},"step-7-simplify-with-limited-dissolve","Step 7: simplify with Limited Dissolve",[12,296,297,298,301,302,305],{},"STL files are all triangles. ",[16,299,300],{},"Mesh > Clean Up > Limited Dissolve"," merges flat neighbouring faces whose angle is below ",[16,303,304],{},"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.",[12,307,308,309,312,313,316,317,320,321,325],{},"Run ",[16,310,311],{},"Face > Tris to Quads"," (",[16,314,315],{},"Triangles to Quads"," in 5.x, ",[67,318,319],{},"Alt+J",") afterwards for the remaining triangles, and see ",[286,322,324],{"href":323},"\u002Fguides\u002Fngons-to-quads","turning n-gons and triangles into quads"," for what to do with leftover n-gons.",[36,327,329],{"id":328},"the-order-in-one-list","The order in one list",[199,331,332,335,338,341,344,347],{},[113,333,334],{},"Import the file and select everything.",[113,336,337],{},"Merge by Distance, raising the distance if the surface is still open everywhere.",[113,339,340],{},"Delete Loose.",[113,342,343],{},"Recalculate Normals.",[113,345,346],{},"Select Non Manifold, then fill the holes.",[113,348,349],{},"Limited Dissolve, then Tris to Quads.",[36,351,353],{"id":352},"methods-compared","Methods compared",[355,356,357,376],"table",{},[358,359,360],"thead",{},[361,362,363,367,370,373],"tr",{},[364,365,366],"th",{},"Problem",[364,368,369],{},"Built-in step",[364,371,372],{},"What it gives",[364,374,375],{},"Limit",[377,378,379,393,406,419,436],"tbody",{},[361,380,381,385,387,390],{},[382,383,384],"td",{},"Unwelded vertices",[382,386,18],{},[382,388,389],{},"Shared vertices",[382,391,392],{},"Distance must match the gap",[361,394,395,398,400,403],{},[382,396,397],{},"Stray vertices, edges",[382,399,22],{},[382,401,402],{},"Cleaner mesh",[382,404,405],{},"Faces option can delete real shells",[361,407,408,411,413,416],{},[382,409,410],{},"Inside-out faces",[382,412,172],{},[382,414,415],{},"Consistent normals",[382,417,418],{},"Needs connected faces",[361,420,421,424,430,433],{},[382,422,423],{},"Holes",[382,425,426,427,429],{},"Fill Holes, ",[67,428,270],{},", Grid Fill",[382,431,432],{},"N-gon, or quads on even loops",[382,434,435],{},"Fill Holes stops at Sides, Grid Fill needs even loops",[361,437,438,441,444,447],{},[382,439,440],{},"Triangle soup",[382,442,443],{},"Limited Dissolve, Alt+J",[382,445,446],{},"Quads and some n-gons",[382,448,449],{},"Curved areas keep triangles or n-gons",[36,451,453],{"id":452},"what-can-go-wrong","What can go wrong",[110,455,456,462,468,476],{},[113,457,458,461],{},[16,459,460],{},"Everything is selected as non-manifold."," The mesh is unwelded. Go back to Merge by Distance with a larger distance.",[113,463,464,467],{},[16,465,466],{},"The model collapses after merging."," The distance is too large for the model's scale.",[113,469,470,473,474,220],{},[16,471,472],{},"Shading is dark in patches."," Check Face Orientation, then run ",[67,475,172],{},[113,477,478,481,482,484],{},[16,479,480],{},"Fill Holes does nothing."," The hole has more sides than the ",[16,483,263],{}," setting.",[36,486,488],{"id":487},"faster-with-quadfix","Faster with QuadFix",[12,490,491,495,496,499],{},[286,492,494],{"href":493},"\u002Faddons\u002Fquadfix","QuadFix"," has a ",[16,497,498],{},"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.",[199,501,502,518,524],{},[113,503,85,504,506,507,509,510,513,514,517],{},[67,505,69],{},", open the ",[16,508,494],{}," tab in the sidebar (",[67,511,512],{},"N","), and press ",[16,515,516],{},"Select Non-Quads & Holes"," to see how many non-quad faces and boundary edges the mesh has.",[113,519,520,521,220],{},"Select the whole mesh and press ",[16,522,523],{},"Clean & Quad",[113,525,85,526,529],{},[16,527,528],{},"Fill Holes with Quads"," for the openings.",[12,531,532,533,535,536,539,540,543],{},"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. ",[16,534,104],{}," (0.0001 by default), ",[16,537,538],{},"Dissolve Angle"," (5 degrees) and ",[16,541,542],{},"Keep Sharp Edges"," are on the panel.",[12,545,546,547,550,551,555,556,560],{},"Know the limits. Fill Holes keeps the patch triangular when the surrounding mesh is all triangles (",[16,548,549],{},"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 ",[286,552,554],{"href":553},"\u002Fdocs\u002Fquadfix\u002Fpanel","panel reference"," lists every option and the ",[286,557,559],{"href":558},"\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.",[36,562,564],{"id":563},"related-guides","Related guides",[110,566,567,571],{},[113,568,569],{},[286,570,289],{"href":288},[113,572,573],{},[286,574,575],{"href":323},"How to turn n-gons and triangles into quads in Blender",{"title":577,"searchDepth":578,"depth":578,"links":579},"",2,[580,581,582,583,584,585,586,587,588,589,590,591],{"id":38,"depth":578,"text":39},{"id":81,"depth":578,"text":82},{"id":130,"depth":578,"text":131},{"id":161,"depth":578,"text":162},{"id":196,"depth":578,"text":197},{"id":248,"depth":578,"text":249},{"id":293,"depth":578,"text":294},{"id":328,"depth":578,"text":329},{"id":352,"depth":578,"text":353},{"id":452,"depth":578,"text":453},{"id":487,"depth":578,"text":488},{"id":563,"depth":578,"text":564},"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":6,"description":592},"guides\u002Fclean-up-imported-stl","2026-11-16","\u002Fmedia\u002Fquadfix.mp4","LGdNC34sZ7mSiIW8f3dFZFruzcTXvAwccIxSdPQkyNo",{"id":605,"title":606,"addon":607,"body":608,"description":1324,"extension":593,"meta":1325,"navigation":595,"path":1326,"poster":1327,"rawbody":1328,"seo":1329,"stem":1330,"updated":601,"video":1331,"__hash__":1332},"guides\u002Fguides\u002Fdifferent-image-per-instance.md","Different image on each instance in Blender","image-per-instance",{"type":9,"value":609,"toc":1308},[610,613,617,632,635,639,642,673,676,680,683,688,691,706,710,734,859,865,869,886,890,893,942,945,972,975,979,982,1050,1060,1066,1070,1080,1097,1100,1104,1111,1114,1118,1154,1158,1241,1245,1255,1258,1296,1304],[12,611,612],{},"Blender has no \"image index per object\" input, so one shared material shows one image everywhere. To give each object or instance its own picture, either use one material per image, or pack all images into one atlas and let each object pick its cell through a number the shader can read (an object custom property, or a named attribute stored on a Geometry Nodes instance). The first is fine for a handful of images. The second is the one that scales to dozens, and I ran every step below in Blender 4.2, 4.5 and 5.2.",[36,614,616],{"id":615},"why-the-obvious-node-setup-only-gives-colours","Why the obvious node setup only gives colours",[12,618,619,620,623,624,627,628,631],{},"The first thing most people try is ",[16,621,622],{},"Object Info",". Its ",[16,625,626],{},"Random"," output is a different number from 0 to 1 for every object, and for every Geometry Nodes instance too. Plug it into a ",[16,629,630],{},"Color Ramp"," and each object gets its own colour.",[12,633,634],{},"That is a colour, not a picture. The Image Texture node loads one image and has no socket for \"which image\". Random into a Color Ramp suits randomised tints and stops there. What you need is a number per object that chooses an image.",[36,636,638],{"id":637},"method-1-one-material-per-image","Method 1: one material per image",[12,640,641],{},"For a handful of pictures this is the simplest thing that works and needs no node maths.",[199,643,644,651,666],{},[113,645,646,647,650],{},"Select the object and open the ",[16,648,649],{},"Material Properties"," tab.",[113,652,653,654,657,658,661,662,665],{},"Create a material, add an ",[16,655,656],{},"Image Texture"," node, open the picture and connect ",[16,659,660],{},"Color"," to the ",[16,663,664],{},"Base Color"," of the Principled BSDF.",[113,667,668,669,672],{},"Duplicate the object (",[16,670,671],{},"Shift D",") and give the copy the next material, one object per picture.",[12,674,675],{},"It breaks down when pictures multiply: every new one means a new material and a manual assignment. Instances from Instance on Points or the Array modifier share the material of their source, so they cannot get different pictures this way at all.",[36,677,679],{"id":678},"method-2-an-atlas-with-a-uv-offset-per-object","Method 2: an atlas with a UV offset per object",[12,681,682],{},"This is the method that scales. All pictures go into one image laid out in a grid, and the shader shifts the UVs so each object looks at one cell.",[684,685,687],"h3",{"id":686},"make-the-atlas","Make the atlas",[12,689,690],{},"Put your pictures into a grid of equal cells in any image editor, for example 2 columns by 2 rows for four images, and save one image. Cell 0 is bottom-left, cell 1 is to its right, and rows count upward, because UV space starts at the bottom-left.",[12,692,693,694,697,698,701,702,705],{},"Set the Image Texture node's ",[16,695,696],{},"Interpolation"," to ",[16,699,700],{},"Closest"," while you test. With ",[16,703,704],{},"Linear",", neighbouring cells can bleed into each other at the edges, so leave a few pixels of padding between pictures when you switch it back.",[684,707,709],{"id":708},"build-the-shader","Build the shader",[12,711,712,713,716,717,720,721,724,725,727,728,730,731,220],{},"Use an index number ",[67,714,715],{},"i"," from 0 to the number of cells minus one. For a grid with ",[67,718,719],{},"cols"," columns and ",[67,722,723],{},"rows"," rows, the cell column is ",[67,726,715],{}," modulo ",[67,729,719],{}," and the row is ",[67,732,733],{},"floor(i \u002F cols)",[199,735,736,757,779,793,810,834,843],{},[113,737,738,739,742,743,746,747,750,751,697,754,220],{},"Add ",[16,740,741],{},"Texture Coordinate"," and take its ",[16,744,745],{},"UV"," output into a ",[16,748,749],{},"Mapping"," node. Set ",[16,752,753],{},"Type",[16,755,756],{},"Point",[113,758,759,760,697,762,54,765,54,768,770,771,54,774,54,776,778],{},"Set Mapping ",[16,761,53],{},[67,763,764],{},"1\u002Fcols",[67,766,767],{},"1\u002Frows",[67,769,205],{},". For the 2 by 2 atlas that is ",[67,772,773],{},"0.5",[67,775,773],{},[67,777,205],{},". This shrinks the UV square to one cell.",[113,780,781,782,785,786,789,790,792],{},"Add a ",[16,783,784],{},"Math"," node set to ",[16,787,788],{},"Floored Modulo"," with the second value ",[67,791,719],{},". This is the column.",[113,794,781,795,785,797,800,801,803,804,785,806,809],{},[16,796,784],{},[16,798,799],{},"Divide"," by ",[67,802,719],{},", then a ",[16,805,784],{},[16,807,808],{},"Floor",". This is the row.",[113,811,812,813,815,816,818,819,822,823,145,826,829,830,833],{},"Divide the column by ",[67,814,719],{}," and the row by ",[67,817,723],{}," with two more ",[16,820,821],{},"Math > Divide"," nodes, and put the results into ",[16,824,825],{},"X",[16,827,828],{},"Y"," of a ",[16,831,832],{},"Combine XYZ"," node.",[113,835,836,837,661,839,842],{},"Connect ",[16,838,832],{},[16,840,841],{},"Location"," input of the Mapping node.",[113,844,845,846,849,850,852,853,855,856,858],{},"Connect Mapping ",[16,847,848],{},"Vector"," to the Image Texture ",[16,851,848],{},", and its ",[16,854,660],{}," to the Principled BSDF ",[16,857,664],{}," (or to an Emission node for a screen).",[12,860,861,862,864],{},"Now the only missing piece is how the index ",[67,863,715],{}," gets to each object.",[684,866,868],{"id":867},"option-a-random-index-from-object-info","Option A: random index from Object Info",[12,870,836,871,874,875,878,879,882,883,885],{},[16,872,873],{},"Object Info > Random"," to a ",[16,876,877],{},"Math > Multiply"," by the number of cells, then to a ",[16,880,881],{},"Math > Floor",", and feed the result into the chain above as ",[67,884,715],{},". In my test, four planes with one shared material got green, blue, blue and red. Random picks repeat, with few objects some pictures may not appear at all, and you cannot choose which object shows what.",[684,887,889],{"id":888},"option-b-a-custom-property-per-object","Option B: a custom property per object",[12,891,892],{},"When you want control, or no repeats:",[199,894,895,917,920],{},[113,896,897,898,901,902,905,906,909,910,913,914,220],{},"Select an object. Open the ",[16,899,900],{},"Object Properties"," tab, ",[16,903,904],{},"Custom Properties"," panel, and press ",[16,907,908],{},"New",". Name it ",[67,911,912],{},"img_index",", type ",[16,915,916],{},"Float",[113,918,919],{},"Type the cell number as the value.",[113,921,922,923,926,927,697,929,145,932,697,935,937,938,941],{},"In the shader add an ",[16,924,925],{},"Attribute"," node, set ",[16,928,753],{},[16,930,931],{},"Object",[16,933,934],{},"Name",[67,936,912],{},", and connect its ",[16,939,940],{},"Fac"," output to the index chain.",[12,943,944],{},"For many objects, set it from the Scripting workspace:",[946,947,951],"pre",{"className":948,"code":949,"language":950,"meta":577,"style":577},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import bpy\nfor i, ob in enumerate(bpy.context.selected_objects):\n    ob[\"img_index\"] = float(i % 4)\n","python",[67,952,953,961,966],{"__ignoreMap":577},[954,955,958],"span",{"class":956,"line":957},"line",1,[954,959,960],{},"import bpy\n",[954,962,963],{"class":956,"line":578},[954,964,965],{},"for i, ob in enumerate(bpy.context.selected_objects):\n",[954,967,969],{"class":956,"line":968},3,[954,970,971],{},"    ob[\"img_index\"] = float(i % 4)\n",[12,973,974],{},"In my test, planes given 3, 0, 2 and 1 showed the cells 3, 0, 2 and 1 of the atlas.",[684,976,978],{"id":977},"option-c-geometry-nodes-instances","Option C: Geometry Nodes instances",[12,980,981],{},"Instances do not have custom properties, but they can carry a named attribute.",[199,983,984,1006,1029],{},[113,985,986,987,990,991,750,994,697,997,145,999,697,1002,1005],{},"In your Geometry Nodes tree, after ",[16,988,989],{},"Instance on Points",", add a ",[16,992,993],{},"Store Named Attribute",[16,995,996],{},"Data Type",[16,998,916],{},[16,1000,1001],{},"Domain",[16,1003,1004],{},"Instance",". The domain is the thing people miss, because the default is Point.",[113,1007,1008,1009,697,1011,1013,1014,1017,1018,1020,1021,1024,1025,1028],{},"Set the ",[16,1010,934],{},[67,1012,912],{},", and connect ",[16,1015,1016],{},"Index"," (from the ",[16,1019,1016],{}," node) to ",[16,1022,1023],{},"Value",". Use a ",[16,1026,1027],{},"Math > Modulo"," if you have more instances than images.",[113,1030,1031,1032,1034,1035,1037,1038,145,1041,1043,1044,1046,1047,1049],{},"In the shader, add an ",[16,1033,925],{}," node with ",[16,1036,753],{}," set to ",[16,1039,1040],{},"Instancer",[16,1042,934],{}," ",[67,1045,912],{},", and feed its ",[16,1048,940],{}," into the same index chain.",[12,1051,1052,1053,1056,1057,1059],{},"The instanced geometry must use that material (a ",[16,1054,1055],{},"Set Material"," node before Instance on Points). My four instances showed four different cells. For random picks only, ",[16,1058,873],{}," also differs per instance, so Option A works on instances without any attribute.",[1061,1062,1063],"blockquote",{},[12,1064,1065],{},"The Index node follows the order the points were generated, which for a Grid is column by column in my test. To put a specific picture at a specific place, check the order first.",[36,1067,1069],{"id":1068},"method-3-udim-tiles","Method 3: UDIM tiles",[12,1071,1072,1073,145,1076,1079],{},"A UDIM image has numbered tiles. Tile 1001 is the UV square from 0 to 1, tile 1002 the next square to the right, and so on. You can load files named ",[67,1074,1075],{},"name.1001.png",[67,1077,1078],{},"name.1002.png"," as one tiled image.",[12,1081,1082,1083,1085,1086,1089,1090,1092,1093,1096],{},"Each object still has to look at its own tile, so the shader is the same job as the atlas: a ",[16,1084,749],{}," node whose ",[16,1087,1088],{},"Location X"," comes from an ",[16,1091,925],{}," node. I tested it. With a custom property ",[67,1094,1095],{},"udim_u"," of 0 or 1 on four planes, they showed tile 1001 and tile 1002 alternately.",[12,1098,1099],{},"UDIM does not save work here. You still need an index per object, plus one file per tile and the naming convention. It suits one model with several high-resolution texture areas, not a hundred different posters.",[36,1101,1103],{"id":1102},"method-4-an-image-sequence-with-a-frame-offset","Method 4: an image sequence with a frame offset",[12,1105,1106,1107,1110],{},"An image sequence is a numbered series of files that Blender steps through by frame. Set the Image Texture node to a sequence and use its ",[16,1108,1109],{},"Offset"," to shift where each material starts.",[12,1112,1113],{},"The offset belongs to the node, so every object with that material shares it. I rendered three planes with three materials at offsets 0, 1 and 2 on frame 1 and got three different pictures. That works, but it is Method 1 again: one material per offset. I did not find a stock way to drive the offset per object from one material, so for a different picture per object an atlas is easier.",[36,1115,1117],{"id":1116},"what-goes-wrong","What goes wrong",[110,1119,1120,1126,1132,1138,1147],{},[113,1121,1122,1125],{},[16,1123,1124],{},"Pictures look squashed."," A portrait picture in a square cell is stretched. Make the cells the shape of your pictures.",[113,1127,1128,1131],{},[16,1129,1130],{},"Seams show neighbouring pictures."," Linear filtering reads across cell borders. Leave padding or inset the UVs a pixel or two.",[113,1133,1134,1137],{},[16,1135,1136],{},"All instances show the same cell."," The named attribute is stored on the Point domain, not Instance, or the shader Attribute node is set to Geometry instead of Instancer.",[113,1139,1140,1143,1144,1146],{},[16,1141,1142],{},"Every object shows the first picture."," The Attribute node finds no attribute with that name and returns 0. Check that ",[67,1145,912],{}," is spelled the same in the property or Store Named Attribute and in the Attribute node. I tested a misspelled name and a missing property in 4.2.23 and 5.2.2, and all four planes showed cell 0.",[113,1148,1149,1150,220],{},"More fixes are on the ",[286,1151,1153],{"href":1152},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting","Image Per Instance troubleshooting page",[36,1155,1157],{"id":1156},"which-method-fits","Which method fits",[355,1159,1160,1173],{},[358,1161,1162],{},[361,1163,1164,1167,1170],{},[364,1165,1166],{},"Method",[364,1168,1169],{},"Good for",[364,1171,1172],{},"Breaks when",[377,1174,1175,1186,1197,1208,1219,1230],{},[361,1176,1177,1180,1183],{},[382,1178,1179],{},"One material per image",[382,1181,1182],{},"Up to about ten pictures",[382,1184,1185],{},"Instances, many pictures, later changes",[361,1187,1188,1191,1194],{},[382,1189,1190],{},"Atlas + Object Info Random",[382,1192,1193],{},"Random look on many objects",[382,1195,1196],{},"You need a chosen or even spread",[361,1198,1199,1202,1205],{},[382,1200,1201],{},"Atlas + custom property",[382,1203,1204],{},"Chosen picture per separate object",[382,1206,1207],{},"Instances, since they have no custom properties",[361,1209,1210,1213,1216],{},[382,1211,1212],{},"Atlas + Store Named Attribute",[382,1214,1215],{},"Array and Instance on Points",[382,1217,1218],{},"Needs a Geometry Nodes tree and a shader chain",[361,1220,1221,1224,1227],{},[382,1222,1223],{},"UDIM",[382,1225,1226],{},"One model with several texture areas",[382,1228,1229],{},"Many different pictures",[361,1231,1232,1235,1238],{},[382,1233,1234],{},"Image sequence",[382,1236,1237],{},"Animated or numbered pictures",[382,1239,1240],{},"Per-object offset on one material",[36,1242,1244],{"id":1243},"faster-with-image-per-instance","Faster with Image Per Instance",[12,1246,1247,1251,1252,1254],{},[286,1248,1250],{"href":1249},"\u002Faddons\u002Fimage-per-instance","Image Per Instance"," builds the atlas method for you, using the same technique as above. It stores an ",[67,1253,912],{}," value (an object custom property on separate objects, and a Store Named Attribute on the Instance domain on instances), and one shared material reads it with an Attribute node. That is the setup you just built by hand.",[12,1256,1257],{},"What it does in practice:",[199,1259,1260,1272,1282],{},[113,1261,1262,1263,54,1265,1267,1268,1271],{},"Pick a folder of images in the sidebar tab (",[16,1264,512],{},[16,1266,1250],{},") and press ",[16,1269,1270],{},"Build Atlas",". The images are packed into one atlas inside the .blend, in file-name order.",[113,1273,1274,1275,1278,1279,220],{},"Select objects and press ",[16,1276,1277],{},"Apply To Selected Objects",", or make the object with the Instance on Points or Array modifier active and press ",[16,1280,1281],{},"Add To Instances (Geometry Nodes)",[113,1283,1284,1285,697,1288,1291,1292,1295],{},"Set ",[16,1286,1287],{},"Order",[16,1289,1290],{},"Shuffle"," to use every image once before any repeats, and change the ",[16,1293,1294],{},"Seed"," for another arrangement.",[12,1297,1298,1299,1303],{},"It also covers padding between cells, tile shape and fit modes so pictures are not squashed, choosing a picture per object or matching it by object name, and mapping without UVs. The limits (one atlas per file, 16384 px per side) are on the product page, and the steps are in the ",[286,1300,1302],{"href":1301},"\u002Fdocs\u002Fimage-per-instance\u002Fworkflows","Image Per Instance workflows",". It needs Blender 4.2 or newer. The free Image Per Instance Lite builds the atlas and applies it to separate objects, up to 20 images, without Geometry Nodes instances or Shuffle. For a few pictures once, the manual atlas above is free and works.",[1305,1306,1307],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":577,"searchDepth":578,"depth":578,"links":1309},[1310,1311,1312,1319,1320,1321,1322,1323],{"id":615,"depth":578,"text":616},{"id":637,"depth":578,"text":638},{"id":678,"depth":578,"text":679,"children":1313},[1314,1315,1316,1317,1318],{"id":686,"depth":968,"text":687},{"id":708,"depth":968,"text":709},{"id":867,"depth":968,"text":868},{"id":888,"depth":968,"text":889},{"id":977,"depth":968,"text":978},{"id":1068,"depth":578,"text":1069},{"id":1102,"depth":578,"text":1103},{"id":1116,"depth":578,"text":1117},{"id":1156,"depth":578,"text":1157},{"id":1243,"depth":578,"text":1244},"Give every object, array copy or Geometry Nodes instance its own image in Blender: one material per image, an atlas with UV offsets, UDIM, or a faster add-on.",{},"\u002Fguides\u002Fdifferent-image-per-instance","\u002Fmedia\u002Fipi.jpg","---\ntitle: \"Different image on each instance in Blender\"\ndescription: \"Give every object, array copy or Geometry Nodes instance its own image in Blender: one material per image, an atlas with UV offsets, UDIM, or a faster add-on.\"\naddon: image-per-instance\nvideo: \u002Fmedia\u002Fipi.mp4\nposter: \u002Fmedia\u002Fipi.jpg\nupdated: 2026-11-16\n---\n\nBlender has no \"image index per object\" input, so one shared material shows one image everywhere. To give each object or instance its own picture, either use one material per image, or pack all images into one atlas and let each object pick its cell through a number the shader can read (an object custom property, or a named attribute stored on a Geometry Nodes instance). The first is fine for a handful of images. The second is the one that scales to dozens, and I ran every step below in Blender 4.2, 4.5 and 5.2.\n\n## Why the obvious node setup only gives colours\n\nThe first thing most people try is **Object Info**. Its **Random** output is a different number from 0 to 1 for every object, and for every Geometry Nodes instance too. Plug it into a **Color Ramp** and each object gets its own colour.\n\nThat is a colour, not a picture. The Image Texture node loads one image and has no socket for \"which image\". Random into a Color Ramp suits randomised tints and stops there. What you need is a number per object that chooses an image.\n\n## Method 1: one material per image\n\nFor a handful of pictures this is the simplest thing that works and needs no node maths.\n\n1. Select the object and open the **Material Properties** tab.\n2. Create a material, add an **Image Texture** node, open the picture and connect **Color** to the **Base Color** of the Principled BSDF.\n3. Duplicate the object (**Shift D**) and give the copy the next material, one object per picture.\n\nIt breaks down when pictures multiply: every new one means a new material and a manual assignment. Instances from Instance on Points or the Array modifier share the material of their source, so they cannot get different pictures this way at all.\n\n## Method 2: an atlas with a UV offset per object\n\nThis is the method that scales. All pictures go into one image laid out in a grid, and the shader shifts the UVs so each object looks at one cell.\n\n### Make the atlas\n\nPut your pictures into a grid of equal cells in any image editor, for example 2 columns by 2 rows for four images, and save one image. Cell 0 is bottom-left, cell 1 is to its right, and rows count upward, because UV space starts at the bottom-left.\n\nSet the Image Texture node's **Interpolation** to **Closest** while you test. With **Linear**, neighbouring cells can bleed into each other at the edges, so leave a few pixels of padding between pictures when you switch it back.\n\n### Build the shader\n\nUse an index number `i` from 0 to the number of cells minus one. For a grid with `cols` columns and `rows` rows, the cell column is `i` modulo `cols` and the row is `floor(i \u002F cols)`.\n\n1. Add **Texture Coordinate** and take its **UV** output into a **Mapping** node. Set **Type** to **Point**.\n2. Set Mapping **Scale** to `1\u002Fcols`, `1\u002Frows`, `1`. For the 2 by 2 atlas that is `0.5`, `0.5`, `1`. This shrinks the UV square to one cell.\n3. Add a **Math** node set to **Floored Modulo** with the second value `cols`. This is the column.\n4. Add a **Math** node set to **Divide** by `cols`, then a **Math** node set to **Floor**. This is the row.\n5. Divide the column by `cols` and the row by `rows` with two more **Math > Divide** nodes, and put the results into **X** and **Y** of a **Combine XYZ** node.\n6. Connect **Combine XYZ** to the **Location** input of the Mapping node.\n7. Connect Mapping **Vector** to the Image Texture **Vector**, and its **Color** to the Principled BSDF **Base Color** (or to an Emission node for a screen).\n\nNow the only missing piece is how the index `i` gets to each object.\n\n### Option A: random index from Object Info\n\nConnect **Object Info > Random** to a **Math > Multiply** by the number of cells, then to a **Math > Floor**, and feed the result into the chain above as `i`. In my test, four planes with one shared material got green, blue, blue and red. Random picks repeat, with few objects some pictures may not appear at all, and you cannot choose which object shows what.\n\n### Option B: a custom property per object\n\nWhen you want control, or no repeats:\n\n1. Select an object. Open the **Object Properties** tab, **Custom Properties** panel, and press **New**. Name it `img_index`, type **Float**.\n2. Type the cell number as the value.\n3. In the shader add an **Attribute** node, set **Type** to **Object** and **Name** to `img_index`, and connect its **Fac** output to the index chain.\n\nFor many objects, set it from the Scripting workspace:\n\n```python\nimport bpy\nfor i, ob in enumerate(bpy.context.selected_objects):\n    ob[\"img_index\"] = float(i % 4)\n```\n\nIn my test, planes given 3, 0, 2 and 1 showed the cells 3, 0, 2 and 1 of the atlas.\n\n### Option C: Geometry Nodes instances\n\nInstances do not have custom properties, but they can carry a named attribute.\n\n1. In your Geometry Nodes tree, after **Instance on Points**, add a **Store Named Attribute** node. Set **Data Type** to **Float** and **Domain** to **Instance**. The domain is the thing people miss, because the default is Point.\n2. Set the **Name** to `img_index`, and connect **Index** (from the **Index** node) to **Value**. Use a **Math > Modulo** if you have more instances than images.\n3. In the shader, add an **Attribute** node with **Type** set to **Instancer** and **Name** `img_index`, and feed its **Fac** into the same index chain.\n\nThe instanced geometry must use that material (a **Set Material** node before Instance on Points). My four instances showed four different cells. For random picks only, **Object Info > Random** also differs per instance, so Option A works on instances without any attribute.\n\n> The Index node follows the order the points were generated, which for a Grid is column by column in my test. To put a specific picture at a specific place, check the order first.\n\n## Method 3: UDIM tiles\n\nA UDIM image has numbered tiles. Tile 1001 is the UV square from 0 to 1, tile 1002 the next square to the right, and so on. You can load files named `name.1001.png` and `name.1002.png` as one tiled image.\n\nEach object still has to look at its own tile, so the shader is the same job as the atlas: a **Mapping** node whose **Location X** comes from an **Attribute** node. I tested it. With a custom property `udim_u` of 0 or 1 on four planes, they showed tile 1001 and tile 1002 alternately.\n\nUDIM does not save work here. You still need an index per object, plus one file per tile and the naming convention. It suits one model with several high-resolution texture areas, not a hundred different posters.\n\n## Method 4: an image sequence with a frame offset\n\nAn image sequence is a numbered series of files that Blender steps through by frame. Set the Image Texture node to a sequence and use its **Offset** to shift where each material starts.\n\nThe offset belongs to the node, so every object with that material shares it. I rendered three planes with three materials at offsets 0, 1 and 2 on frame 1 and got three different pictures. That works, but it is Method 1 again: one material per offset. I did not find a stock way to drive the offset per object from one material, so for a different picture per object an atlas is easier.\n\n## What goes wrong\n\n- **Pictures look squashed.** A portrait picture in a square cell is stretched. Make the cells the shape of your pictures.\n- **Seams show neighbouring pictures.** Linear filtering reads across cell borders. Leave padding or inset the UVs a pixel or two.\n- **All instances show the same cell.** The named attribute is stored on the Point domain, not Instance, or the shader Attribute node is set to Geometry instead of Instancer.\n- **Every object shows the first picture.** The Attribute node finds no attribute with that name and returns 0. Check that `img_index` is spelled the same in the property or Store Named Attribute and in the Attribute node. I tested a misspelled name and a missing property in 4.2.23 and 5.2.2, and all four planes showed cell 0.\n- More fixes are on the [Image Per Instance troubleshooting page](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\n## Which method fits\n\n| Method | Good for | Breaks when |\n|---|---|---|\n| One material per image | Up to about ten pictures | Instances, many pictures, later changes |\n| Atlas + Object Info Random | Random look on many objects | You need a chosen or even spread |\n| Atlas + custom property | Chosen picture per separate object | Instances, since they have no custom properties |\n| Atlas + Store Named Attribute | Array and Instance on Points | Needs a Geometry Nodes tree and a shader chain |\n| UDIM | One model with several texture areas | Many different pictures |\n| Image sequence | Animated or numbered pictures | Per-object offset on one material |\n\n## Faster with Image Per Instance\n\n[Image Per Instance](\u002Faddons\u002Fimage-per-instance) builds the atlas method for you, using the same technique as above. It stores an `img_index` value (an object custom property on separate objects, and a Store Named Attribute on the Instance domain on instances), and one shared material reads it with an Attribute node. That is the setup you just built by hand.\n\nWhat it does in practice:\n\n1. Pick a folder of images in the sidebar tab (**N**, **Image Per Instance**) and press **Build Atlas**. The images are packed into one atlas inside the .blend, in file-name order.\n2. Select objects and press **Apply To Selected Objects**, or make the object with the Instance on Points or Array modifier active and press **Add To Instances (Geometry Nodes)**.\n3. Set **Order** to **Shuffle** to use every image once before any repeats, and change the **Seed** for another arrangement.\n\nIt also covers padding between cells, tile shape and fit modes so pictures are not squashed, choosing a picture per object or matching it by object name, and mapping without UVs. The limits (one atlas per file, 16384 px per side) are on the product page, and the steps are in the [Image Per Instance workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows). It needs Blender 4.2 or newer. The free Image Per Instance Lite builds the atlas and applies it to separate objects, up to 20 images, without Geometry Nodes instances or Shuffle. For a few pictures once, the manual atlas above is free and works.\n\n",{"title":606,"description":1324},"guides\u002Fdifferent-image-per-instance","\u002Fmedia\u002Fipi.mp4","ymzHDoZ-AQtQ92lHUzBlryC9kbv16MS3nnFdblJlXqM",{"id":1334,"title":289,"addon":7,"body":1335,"description":1827,"extension":593,"meta":1828,"navigation":595,"path":288,"poster":597,"rawbody":1829,"seo":1830,"stem":1831,"updated":601,"video":602,"__hash__":1832},"guides\u002Fguides\u002Ffill-hole-with-quads.md",{"type":9,"value":1336,"toc":1812},[1337,1343,1346,1350,1360,1364,1387,1396,1400,1406,1410,1427,1431,1434,1465,1477,1483,1487,1494,1498,1505,1521,1524,1528,1533,1553,1563,1567,1688,1690,1725,1727,1735,1757,1760,1789,1799,1801],[12,1338,1339,1340,1342],{},"To fill a hole with quads in Blender, select the edge loop around the hole and use ",[16,1341,276],{},". It builds a quad grid across the opening, but only when the loop has an even number of edges. For a hole with an odd edge count, an irregular outline or a gap between two loops, you need one of the workarounds below, or a tool that does it in one click.",[12,1344,1345],{},"This guide covers each built-in method, what it produces and where it breaks. I tested every result in Blender 4.2.23 and 5.2.2 on a UV sphere with faces deleted. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.",[36,1347,1349],{"id":1348},"why-the-default-fill-is-usually-not-what-you-want","Why the default fill is usually not what you want",[12,1351,1352,1353,1355,1356,1359],{},"Pressing ",[67,1354,270],{}," on a closed edge loop is the obvious first move, and it works, but it creates ",[16,1357,1358],{},"one n-gon"," with as many sides as the loop has edges. In my test, a 12-edge hole became a single 12-sided face, and a 15-edge hole became a single 15-sided face. That is fine for a flat cap, but it shades badly on a curved surface and it is the face type you were probably trying to get rid of.",[36,1361,1363],{"id":1362},"step-1-select-the-edges-around-the-hole","Step 1: select the edges around the hole",[199,1365,1366,1373,1376,1381],{},[113,1367,85,1368,1370,1371,210],{},[67,1369,69],{}," to enter Edit Mode and press ",[67,1372,209],{},[113,1374,1375],{},"Click one edge of the hole.",[113,1377,42,1378,1380],{},[16,1379,283],{},". In my test this selected the whole boundary of that one hole and nothing else, even with a second hole on the mesh. (The menu entry is the same in 4.2 and 5.x.)",[113,1382,1383,1384,1386],{},"Turn on ",[16,1385,77],{}," and read the selected edge count. You need to know whether it is even or odd.",[12,1388,1389,1390,1392,1393,1395],{},"If the mesh has only the one hole, you can instead use ",[16,1391,215],{}," (available in vertex and edge select mode, not in face mode) and keep only ",[16,1394,226],{}," ticked in the Adjust Last Operation panel. That selects every open border on the mesh, so with several holes it selects them all.",[36,1397,1399],{"id":1398},"method-1-f-new-edgeface-from-vertices","Method 1: F (New Edge\u002FFace from Vertices)",[12,1401,1402,1403,1405],{},"With the loop selected, press ",[67,1404,270],{},". The hole is closed by a single n-gon. It cannot fail, and it improves nothing. Use it only when a flat n-gon is acceptable.",[36,1407,1409],{"id":1408},"method-2-face-fill-altf","Method 2: Face > Fill (Alt+F)",[12,1411,1412,1413,169,1416,1419,1420,312,1422,316,1424,1426],{},"With the loop selected, choose ",[16,1414,1415],{},"Face > Fill",[67,1417,1418],{},"Alt+F",". Blender triangulates the hole. In my test a 12-edge loop gave 10 triangles, a 15-edge loop gave 13 and a 16-edge loop gave 14: the edge count minus two. There are no n-gons, but there are no quads either. Running ",[16,1421,311],{},[16,1423,315],{},[67,1425,319],{},") on the result joined only a few pairs of triangles in the 16-edge test, so it is not a way to a clean grid.",[36,1428,1430],{"id":1429},"method-3-grid-fill-ctrlf-grid-fill","Method 3: Grid Fill (Ctrl+F > Grid Fill)",[12,1432,1433],{},"This is the method that gives quads.",[199,1435,1436,1439,1449,1456],{},[113,1437,1438],{},"Select the loop as above.",[113,1440,85,1441,1444,1445,1448],{},[67,1442,1443],{},"Ctrl+F"," to open the Face menu and choose ",[16,1446,1447],{},"Grid Fill",", or use the Face menu in the header.",[113,1450,1451,1452,1455],{},"Open the ",[16,1453,1454],{},"Adjust Last Operation"," panel in the bottom-left corner of the viewport.",[113,1457,1458,1459,145,1462,1464],{},"Change ",[16,1460,1461],{},"Span",[16,1463,1109],{}," until the grid looks straight.",[12,1466,1467,1470,1471,1473,1474,1476],{},[16,1468,1469],{},"Even loops work."," In my test, 12-edge and 16-edge holes were filled with quads only, with no triangles or n-gons created, and the hole's boundary was closed. ",[16,1472,1461],{}," controls how many rows of quads cross the hole (the result changed from 5 to 9 new faces on the 12-edge loop as Span went from 1 to 3, all of them quads). ",[16,1475,1109],{}," rotates where the grid starts on the loop, which helps when the result looks twisted. On the first run Blender chooses the Span itself.",[12,1478,1479,1482],{},[16,1480,1481],{},"Odd loops fail."," On a 15-edge loop nothing happened. Blender only showed the message \"Select two edge loops or a single closed edge loop from which two edge loops can be calculated\". That message does not mention the real cause, which is that a single loop has to be split into two halves of equal length.",[684,1484,1486],{"id":1485},"making-an-odd-loop-even","Making an odd loop even",[12,1488,1489,1490,1493],{},"Add or remove one vertex on the loop. In my test, selecting one edge of the 15-edge loop and subdividing it (",[16,1491,1492],{},"Edge > Subdivide",") made the loop 16 edges long, and Grid Fill then produced quads. The catch is that subdividing a border edge also adds a vertex to the face on the other side of that edge, and that face became a 5-sided n-gon. You trade the hole's n-gon for a small one next to it.",[36,1495,1497],{"id":1496},"method-4-bridge-edge-loops","Method 4: Bridge Edge Loops",[12,1499,1500,1501,1504],{},"If the \"hole\" is really a gap between two openings, such as the two ends of a tube, use ",[16,1502,1503],{},"Edge > Bridge Edge Loops"," instead of filling each hole separately.",[199,1506,1507,1510,1514],{},[113,1508,1509],{},"Select both edge loops.",[113,1511,42,1512,220],{},[16,1513,1503],{},[113,1515,1516,1517,1520],{},"In Adjust Last Operation, raise ",[16,1518,1519],{},"Number of Cuts"," for more rows.",[12,1522,1523],{},"With two 12-edge loops the result was 12 quads and nothing else. Setting Number of Cuts to 2 gave 36 quads, which is three rows of 12. When the two loops had different edge counts (12 and 8 in my test), Blender still bridged them but added 20 triangles to absorb the difference, so keep the counts equal where you can.",[36,1525,1527],{"id":1526},"method-5-poke-and-inset-on-an-n-gon","Method 5: Poke and Inset on an n-gon",[12,1529,1530,1531,220],{},"These are not fills, they are things you do after pressing ",[67,1532,270],{},[110,1534,1535,1544],{},[113,1536,1537,312,1540,1543],{},[16,1538,1539],{},"Face > Poke Faces",[67,1541,1542],{},"Alt+P",") turns the new n-gon into a fan of triangles around a new center vertex. A 16-sided cap became 16 triangles.",[113,1545,1546,312,1549,1552],{},[16,1547,1548],{},"Face > Inset Faces",[67,1550,1551],{},"I",") keeps the n-gon but adds a ring of quads around it. In my test the ring was 16 quads, and the inner 16-sided face was still there.",[12,1554,1555,1556,1558,1559,1562],{},"Neither gives a quad-only fill on its own. To get an all-quad cap, Inset the n-gon, delete the inner face (",[67,1557,825],{}," > ",[16,1560,1561],{},"Only Faces",") and Grid Fill the inner loop. The ring of quads gives the grid a cleaner edge flow. In my test on a 16-sided cylinder cap this gave 16 quads in the ring and 16 in the grid, with no triangles and no n-gon left on that cap. A 12-sided cap gave 12 plus 9 quads, with the same result in 4.2.23 and 5.2.2. A 15-sided cap failed with the usual Grid Fill message, so the inner loop still has to be even.",[36,1564,1566],{"id":1565},"which-method-to-use","Which method to use",[355,1568,1569,1584],{},[358,1570,1571],{},[361,1572,1573,1575,1578,1581],{},[364,1574,1166],{},[364,1576,1577],{},"Needs",[364,1579,1580],{},"Result in my test",[364,1582,1583],{},"Typical problem",[377,1585,1586,1601,1617,1630,1644,1658,1674],{},[361,1587,1588,1592,1595,1598],{},[382,1589,1590],{},[67,1591,270],{},[382,1593,1594],{},"Any closed loop",[382,1596,1597],{},"One n-gon with as many sides as the loop",[382,1599,1600],{},"Bad shading, breaks subdivision",[361,1602,1603,1609,1611,1614],{},[382,1604,1605,1606,1608],{},"Face > Fill (",[67,1607,1418],{},")",[382,1610,1594],{},[382,1612,1613],{},"Edge count minus two triangles",[382,1615,1616],{},"No quads at all",[361,1618,1619,1621,1624,1627],{},[382,1620,1447],{},[382,1622,1623],{},"Even number of edges",[382,1625,1626],{},"Quads only",[382,1628,1629],{},"Fails on odd loops with a confusing message",[361,1631,1632,1635,1638,1641],{},[382,1633,1634],{},"Subdivide, then Grid Fill",[382,1636,1637],{},"Odd loop",[382,1639,1640],{},"Quads plus one 5-sided face next to the hole",[382,1642,1643],{},"A new n-gon next to the patch",[361,1645,1646,1649,1652,1655],{},[382,1647,1648],{},"Bridge Edge Loops",[382,1650,1651],{},"Two loops",[382,1653,1654],{},"Quads when counts match",[382,1656,1657],{},"Triangles when counts differ",[361,1659,1660,1665,1668,1671],{},[382,1661,1662,1663],{},"Poke \u002F Inset after ",[67,1664,270],{},[382,1666,1667],{},"A filled n-gon",[382,1669,1670],{},"Triangle fan, or quad ring with an inner n-gon",[382,1672,1673],{},"Not a quad fill",[361,1675,1676,1679,1682,1685],{},[382,1677,1678],{},"Inset, delete inner face, Grid Fill",[382,1680,1681],{},"An even-sided n-gon cap",[382,1683,1684],{},"Quad ring plus quad grid",[382,1686,1687],{},"Fails when the inner loop is odd",[36,1689,453],{"id":452},[110,1691,1692,1698,1708,1716],{},[113,1693,1694,1697],{},[16,1695,1696],{},"Grid Fill does nothing and shows a message."," The loop is odd, or the selection is not one closed loop. Check the edge count in the statistics overlay.",[113,1699,1700,1703,1704,1707],{},[16,1701,1702],{},"The patch does not follow the surface."," Look at the result from the side. If it sits flat or bulges, move vertices by hand, for example with Proportional Editing (",[67,1705,1706],{},"O",").",[113,1709,1710,1713,1714,220],{},[16,1711,1712],{},"Your mesh is all triangles"," (a scan, an STL). Quads will sit next to triangles however you fill the hole, so decide first whether you want to convert the whole thing, see ",[286,1715,324],{"href":323},[113,1717,1718,1721,1722,220],{},[16,1719,1720],{},"Every edge of the mesh counts as open."," That means the vertices are not welded, which happens with some imported files, and there is no real hole to fill yet. ",[286,1723,1724],{"href":596},"Clean up the mesh first",[36,1726,488],{"id":487},[12,1728,1729,1731,1732,1734],{},[286,1730,494],{"href":493}," is a Blender add-on with a ",[16,1733,528],{}," button. It does the selection, the parity problem and the grid in one click, and it works on several holes at once.",[199,1736,1737,1746,1753],{},[113,1738,85,1739,1741,1742,509,1744,1707],{},[67,1740,69],{}," for Edit Mode and open the ",[16,1743,494],{},[67,1745,512],{},[113,1747,1748,1749,1752],{},"Select the hole, or select the whole mesh if you want every hole filled. With ",[16,1750,1751],{},"Only Selected"," on (the default), only loops that are fully selected are filled.",[113,1754,85,1755,220],{},[16,1756,528],{},[12,1758,1759],{},"What it does that Grid Fill does not, as I tested it in Blender 4.2.23 and 5.2.2:",[110,1761,1762,1768,1774,1780],{},[113,1763,1764,1767],{},[16,1765,1766],{},"Odd loops are filled."," The 15-edge hole that Grid Fill refused was closed in one click. The result was quads plus a single 5-sided face, the same kind of leftover as the manual subdivide trick.",[113,1769,1770,1773],{},[16,1771,1772],{},"Several holes at once."," A mesh with two 12-edge holes was filled in one press, with no triangles or n-gons added. With only one loop selected, only that loop was filled.",[113,1775,1776,1779],{},[16,1777,1778],{},"The panel reports what happened",", for example how many loops were filled and how many quads, triangles and n-gons the mesh has now.",[113,1781,1782,1785,1786,1788],{},[16,1783,1784],{},"The result depends on your mesh."," If the surrounding mesh is triangles, QuadFix keeps the patch triangular by default (",[16,1787,549],{},"). Turn that option off if you want quads next to triangles.",[12,1790,1791,1792,1794,1795,1798],{},"QuadFix repairs the mesh you have. It does not rebuild edge flow like a retopology tool, and on very irregular scans some leftover triangles are unavoidable. The full list of buttons and options is on the ",[286,1793,554],{"href":553},", and ",[286,1796,1797],{"href":558},"workflows"," shows it on typical repairs. The free QuadFix Lite covers n-gon and cleanup operations but not hole filling.",[36,1800,564],{"id":563},[110,1802,1803,1807],{},[113,1804,1805],{},[286,1806,575],{"href":323},[113,1808,1809],{},[286,1810,1811],{"href":596},"How to clean up an imported STL or OBJ mesh in Blender",{"title":577,"searchDepth":578,"depth":578,"links":1813},[1814,1815,1816,1817,1818,1821,1822,1823,1824,1825,1826],{"id":1348,"depth":578,"text":1349},{"id":1362,"depth":578,"text":1363},{"id":1398,"depth":578,"text":1399},{"id":1408,"depth":578,"text":1409},{"id":1429,"depth":578,"text":1430,"children":1819},[1820],{"id":1485,"depth":968,"text":1486},{"id":1496,"depth":578,"text":1497},{"id":1526,"depth":578,"text":1527},{"id":1565,"depth":578,"text":1566},{"id":452,"depth":578,"text":453},{"id":487,"depth":578,"text":488},{"id":563,"depth":578,"text":564},"Fill a hole in a Blender mesh with quads, not an n-gon or a triangle fan. Grid Fill, Bridge Edge Loops and the other options, and when each one fails.",{},"---\ntitle: How to fill a hole with quads in Blender\ndescription: Fill a hole in a Blender mesh with quads, not an n-gon or a triangle fan. Grid Fill, Bridge Edge Loops and the other options, and when each one fails.\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo fill a hole with quads in Blender, select the edge loop around the hole and use **Face > Grid Fill**. It builds a quad grid across the opening, but only when the loop has an even number of edges. For a hole with an odd edge count, an irregular outline or a gap between two loops, you need one of the workarounds below, or a tool that does it in one click.\n\nThis guide covers each built-in method, what it produces and where it breaks. I tested every result in Blender 4.2.23 and 5.2.2 on a UV sphere with faces deleted. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys.\n\n## Why the default fill is usually not what you want\n\nPressing `F` on a closed edge loop is the obvious first move, and it works, but it creates **one n-gon** with as many sides as the loop has edges. In my test, a 12-edge hole became a single 12-sided face, and a 15-edge hole became a single 15-sided face. That is fine for a flat cap, but it shades badly on a curved surface and it is the face type you were probably trying to get rid of.\n\n## Step 1: select the edges around the hole\n\n1. Press `Tab` to enter Edit Mode and press `2` for edge select mode.\n2. Click one edge of the hole.\n3. Choose **Select > Select Loops > Edge Loops**. In my test this selected the whole boundary of that one hole and nothing else, even with a second hole on the mesh. (The menu entry is the same in 4.2 and 5.x.)\n4. Turn on **Overlays > Statistics** and read the selected edge count. You need to know whether it is even or odd.\n\nIf the mesh has only the one hole, you can instead use **Select > Select All by Trait > Non Manifold** (available in vertex and edge select mode, not in face mode) and keep only **Boundaries** ticked in the Adjust Last Operation panel. That selects every open border on the mesh, so with several holes it selects them all.\n\n## Method 1: F (New Edge\u002FFace from Vertices)\n\nWith the loop selected, press `F`. The hole is closed by a single n-gon. It cannot fail, and it improves nothing. Use it only when a flat n-gon is acceptable.\n\n## Method 2: Face > Fill (Alt+F)\n\nWith the loop selected, choose **Face > Fill** or press `Alt+F`. Blender triangulates the hole. In my test a 12-edge loop gave 10 triangles, a 15-edge loop gave 13 and a 16-edge loop gave 14: the edge count minus two. There are no n-gons, but there are no quads either. Running **Face > Tris to Quads** (**Triangles to Quads** in 5.x, `Alt+J`) on the result joined only a few pairs of triangles in the 16-edge test, so it is not a way to a clean grid.\n\n## Method 3: Grid Fill (Ctrl+F > Grid Fill)\n\nThis is the method that gives quads.\n\n1. Select the loop as above.\n2. Press `Ctrl+F` to open the Face menu and choose **Grid Fill**, or use the Face menu in the header.\n3. Open the **Adjust Last Operation** panel in the bottom-left corner of the viewport.\n4. Change **Span** and **Offset** until the grid looks straight.\n\n**Even loops work.** In my test, 12-edge and 16-edge holes were filled with quads only, with no triangles or n-gons created, and the hole's boundary was closed. **Span** controls how many rows of quads cross the hole (the result changed from 5 to 9 new faces on the 12-edge loop as Span went from 1 to 3, all of them quads). **Offset** rotates where the grid starts on the loop, which helps when the result looks twisted. On the first run Blender chooses the Span itself.\n\n**Odd loops fail.** On a 15-edge loop nothing happened. Blender only showed the message \"Select two edge loops or a single closed edge loop from which two edge loops can be calculated\". That message does not mention the real cause, which is that a single loop has to be split into two halves of equal length.\n\n### Making an odd loop even\n\nAdd or remove one vertex on the loop. In my test, selecting one edge of the 15-edge loop and subdividing it (**Edge > Subdivide**) made the loop 16 edges long, and Grid Fill then produced quads. The catch is that subdividing a border edge also adds a vertex to the face on the other side of that edge, and that face became a 5-sided n-gon. You trade the hole's n-gon for a small one next to it.\n\n## Method 4: Bridge Edge Loops\n\nIf the \"hole\" is really a gap between two openings, such as the two ends of a tube, use **Edge > Bridge Edge Loops** instead of filling each hole separately.\n\n1. Select both edge loops.\n2. Choose **Edge > Bridge Edge Loops**.\n3. In Adjust Last Operation, raise **Number of Cuts** for more rows.\n\nWith two 12-edge loops the result was 12 quads and nothing else. Setting Number of Cuts to 2 gave 36 quads, which is three rows of 12. When the two loops had different edge counts (12 and 8 in my test), Blender still bridged them but added 20 triangles to absorb the difference, so keep the counts equal where you can.\n\n## Method 5: Poke and Inset on an n-gon\n\nThese are not fills, they are things you do after pressing `F`.\n\n- **Face > Poke Faces** (`Alt+P`) turns the new n-gon into a fan of triangles around a new center vertex. A 16-sided cap became 16 triangles.\n- **Face > Inset Faces** (`I`) keeps the n-gon but adds a ring of quads around it. In my test the ring was 16 quads, and the inner 16-sided face was still there.\n\nNeither gives a quad-only fill on its own. To get an all-quad cap, Inset the n-gon, delete the inner face (`X` > **Only Faces**) and Grid Fill the inner loop. The ring of quads gives the grid a cleaner edge flow. In my test on a 16-sided cylinder cap this gave 16 quads in the ring and 16 in the grid, with no triangles and no n-gon left on that cap. A 12-sided cap gave 12 plus 9 quads, with the same result in 4.2.23 and 5.2.2. A 15-sided cap failed with the usual Grid Fill message, so the inner loop still has to be even.\n\n## Which method to use\n\n| Method | Needs | Result in my test | Typical problem |\n| --- | --- | --- | --- |\n| `F` | Any closed loop | One n-gon with as many sides as the loop | Bad shading, breaks subdivision |\n| Face > Fill (`Alt+F`) | Any closed loop | Edge count minus two triangles | No quads at all |\n| Grid Fill | Even number of edges | Quads only | Fails on odd loops with a confusing message |\n| Subdivide, then Grid Fill | Odd loop | Quads plus one 5-sided face next to the hole | A new n-gon next to the patch |\n| Bridge Edge Loops | Two loops | Quads when counts match | Triangles when counts differ |\n| Poke \u002F Inset after `F` | A filled n-gon | Triangle fan, or quad ring with an inner n-gon | Not a quad fill |\n| Inset, delete inner face, Grid Fill | An even-sided n-gon cap | Quad ring plus quad grid | Fails when the inner loop is odd |\n\n## What can go wrong\n\n- **Grid Fill does nothing and shows a message.** The loop is odd, or the selection is not one closed loop. Check the edge count in the statistics overlay.\n- **The patch does not follow the surface.** Look at the result from the side. If it sits flat or bulges, move vertices by hand, for example with Proportional Editing (`O`).\n- **Your mesh is all triangles** (a scan, an STL). Quads will sit next to triangles however you fill the hole, so decide first whether you want to convert the whole thing, see [turning n-gons and triangles into quads](\u002Fguides\u002Fngons-to-quads).\n- **Every edge of the mesh counts as open.** That means the vertices are not welded, which happens with some imported files, and there is no real hole to fill yet. [Clean up the mesh first](\u002Fguides\u002Fclean-up-imported-stl).\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) is a Blender add-on with a **Fill Holes with Quads** button. It does the selection, the parity problem and the grid in one click, and it works on several holes at once.\n\n1. Press `Tab` for Edit Mode and open the **QuadFix** tab in the sidebar (`N`).\n2. Select the hole, or select the whole mesh if you want every hole filled. With **Only Selected** on (the default), only loops that are fully selected are filled.\n3. Press **Fill Holes with Quads**.\n\nWhat it does that Grid Fill does not, as I tested it in Blender 4.2.23 and 5.2.2:\n\n- **Odd loops are filled.** The 15-edge hole that Grid Fill refused was closed in one click. The result was quads plus a single 5-sided face, the same kind of leftover as the manual subdivide trick.\n- **Several holes at once.** A mesh with two 12-edge holes was filled in one press, with no triangles or n-gons added. With only one loop selected, only that loop was filled.\n- **The panel reports what happened**, for example how many loops were filled and how many quads, triangles and n-gons the mesh has now.\n- **The result depends on your mesh.** If the surrounding mesh is triangles, QuadFix keeps the patch triangular by default (**Match Triangle Meshes**). Turn that option off if you want quads next to triangles.\n\nQuadFix repairs the mesh you have. It does not rebuild edge flow like a retopology tool, and on very irregular scans some leftover triangles are unavoidable. The full list of buttons and options is on the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel), and [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows) shows it on typical repairs. The free QuadFix Lite covers n-gon and cleanup operations but not hole filling.\n\n## Related guides\n\n- [How to turn n-gons and triangles into quads in Blender](\u002Fguides\u002Fngons-to-quads)\n- [How to clean up an imported STL or OBJ mesh in Blender](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":289,"description":1827},"guides\u002Ffill-hole-with-quads","ubODEO0xa21pFfQSpyev8gnKv3TQZDg1RpFC5HKU9sQ",{"id":1834,"title":1835,"addon":7,"body":1836,"description":2420,"extension":593,"meta":2421,"navigation":595,"path":323,"poster":597,"rawbody":2422,"seo":2423,"stem":2424,"updated":601,"video":602,"__hash__":2425},"guides\u002Fguides\u002Fngons-to-quads.md","Convert n-gons and tris to quads in Blender",{"type":9,"value":1837,"toc":2405},[1838,1861,1871,1875,1909,1920,1924,1941,1944,1948,1997,2000,2061,2072,2076,2079,2099,2102,2109,2113,2116,2141,2148,2152,2165,2169,2176,2180,2199,2210,2212,2298,2300,2323,2325,2333,2355,2358,2384,2393,2395],[12,1839,1840,1841,312,1844,1847,1848,1558,1850,1852,1853,1855,1856,312,1858,1860],{},"To turn an n-gon into quads in Blender, cut it with ",[16,1842,1843],{},"Connect Vertex Path",[67,1845,1846],{},"J",") between two vertices three steps apart, or delete the face (",[67,1849,825],{},[16,1851,1561],{},") and refill the opening with ",[16,1854,276],{},". Both need an even number of sides. For triangles, select them and press ",[67,1857,319],{},[16,1859,311],{},"), which joins neighbouring pairs but ignores n-gons. No built-in tool does both in one go.",[12,1862,1863,1864,1866,1867,1870],{},"I tested every result below in Blender 4.2.23 and 5.2.2 on small test meshes, so the numbers are from real runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys. In Blender 5.x the menu entry is called ",[16,1865,315],{},", in 4.2 it is ",[16,1868,1869],{},"Tris to Quads",". It is the same operator with the same shortcut.",[36,1872,1874],{"id":1873},"step-1-find-the-faces-that-are-not-quads","Step 1: find the faces that are not quads",[199,1876,1877,1886,1891,1904],{},[113,1878,85,1879,1881,1882,1885],{},[67,1880,69],{}," for Edit Mode and press ",[67,1883,1884],{},"3"," for face select mode.",[113,1887,42,1888,220],{},[16,1889,1890],{},"Select > Select All by Trait > Faces by Sides",[113,1892,1893,1894,1897,1898,697,1900,1903],{},"In the Adjust Last Operation panel set ",[16,1895,1896],{},"Number of Vertices"," to 4 and ",[16,1899,753],{},[16,1901,1902],{},"Not Equal To",". This selects every triangle and every n-gon.",[113,1905,1383,1906,1908],{},[16,1907,77],{}," to see how many faces are selected.",[12,1910,1911,1912,1915,1916,1919],{},"On a test grid with one 12-sided n-gon and 16 triangles, Not Equal To selected 17 faces. Type ",[16,1913,1914],{},"Greater Than"," with 4 selected only the n-gon, and ",[16,1917,1918],{},"Less Than"," with 4 selected only the 16 triangles. Use those two to treat triangles and n-gons separately, because they need different tools.",[36,1921,1923],{"id":1922},"step-2-triangles-to-quads-with-altj","Step 2: triangles to quads with Alt+J",[199,1925,1926,1929,1936],{},[113,1927,1928],{},"Select the triangles (or the whole mesh) in Edit Mode.",[113,1930,85,1931,1933,1934,220],{},[67,1932,319],{},", or choose ",[16,1935,311],{},[113,1937,165,1938,1940],{},[16,1939,1454],{}," and tune the options.",[12,1942,1943],{},"When a triangulated quad is simply sitting there, it rejoins cleanly. In my test grid the 16 triangles became 8 quads and none were left. The 12-sided n-gon was left untouched, because this operator only looks at triangles.",[684,1945,1947],{"id":1946},"the-options-that-matter","The options that matter",[355,1949,1950,1963],{},[358,1951,1952],{},[361,1953,1954,1957,1960],{},[364,1955,1956],{},"Option",[364,1958,1959],{},"Default",[364,1961,1962],{},"What it does",[377,1964,1965,1976,1986],{},[361,1966,1967,1970,1973],{},[382,1968,1969],{},"Max Face Angle",[382,1971,1972],{},"40 degrees",[382,1974,1975],{},"How different the two triangle normals may be",[361,1977,1978,1981,1983],{},[382,1979,1980],{},"Max Shape Angle",[382,1982,1972],{},[382,1984,1985],{},"How far the joined quad may be from a rectangle",[361,1987,1988,1991,1994],{},[382,1989,1990],{},"Compare UVs, Color Attributes, Seam, Sharp, Materials",[382,1992,1993],{},"off",[382,1995,1996],{},"When on, triangles are not joined across a UV border, seam, sharp edge or material boundary",[12,1998,1999],{},"The two angle values decide how many triangles survive. On a triangulated UV sphere with its vertices randomly nudged (528 triangles to start), Blender 5.2.2 gave:",[355,2001,2002,2015],{},[358,2003,2004],{},[361,2005,2006,2009,2012],{},[364,2007,2008],{},"Both angles",[364,2010,2011],{},"Triangles left",[364,2013,2014],{},"Quads",[377,2016,2017,2028,2039,2050],{},[361,2018,2019,2022,2025],{},[382,2020,2021],{},"10 degrees",[382,2023,2024],{},"512",[382,2026,2027],{},"8",[361,2029,2030,2033,2036],{},[382,2031,2032],{},"40 degrees (default)",[382,2034,2035],{},"182",[382,2037,2038],{},"173",[361,2040,2041,2044,2047],{},[382,2042,2043],{},"90 degrees",[382,2045,2046],{},"42",[382,2048,2049],{},"243",[361,2051,2052,2055,2058],{},[382,2053,2054],{},"180 degrees",[382,2056,2057],{},"28",[382,2059,2060],{},"250",[12,2062,2063,2064,2067,2068,2071],{},"Blender 4.2.23 gave slightly different counts on the same mesh but the same trend. Higher angles join more pairs, and the quads get less regular. The Compare options work as blockers: with every edge marked as a seam and ",[16,2065,2066],{},"Compare Seam"," on, no triangle was joined at all, and the same happened with every edge sharp and ",[16,2069,2070],{},"Compare Sharp"," on. If Alt+J does nothing on your mesh, look for a Compare option left on, or for edges marked as seams or sharp.",[36,2073,2075],{"id":2074},"step-3-split-an-n-gon-with-connect-vertex-path-j","Step 3: split an n-gon with Connect Vertex Path (J)",[12,2077,2078],{},"An n-gon can only be cut into quads if its number of sides is even: an n-gon with n sides makes (n minus 2) divided by 2 quads. So an 8-gon gives 3 quads and a 6-gon gives 2. An n-gon with an odd number of sides cannot be cut into only quads unless you add a vertex.",[199,2080,2081,2086,2089,2096],{},[113,2082,85,2083,2085],{},[67,2084,205],{}," for vertex select mode.",[113,2087,2088],{},"Click one vertex of the n-gon, then click the vertex three steps further along its outline, so the cut separates a piece with four corners.",[113,2090,42,2091,169,2094,220],{},[16,2092,2093],{},"Vertex > Connect Vertex Path",[67,2095,1846],{},[113,2097,2098],{},"Repeat on the remaining n-gon until only quads are left.",[12,2100,2101],{},"Blender uses the order in which you selected the vertices, so click them one after the other instead of box-selecting. In my test an 8-sided n-gon was cut once, which gave a quad and a 6-sided n-gon. Cutting the 6-gon once more gave two quads. Three quads in total, no triangles.",[1061,2103,2104],{},[12,2105,2106,2107,220],{},"A cut in the wrong place leaves two smaller n-gons instead of quads. Count the steps between your two picks before pressing ",[67,2108,1846],{},[36,2110,2112],{"id":2111},"step-4-delete-the-n-gon-and-grid-fill-it","Step 4: delete the n-gon and Grid Fill it",[12,2114,2115],{},"For a large n-gon with an even number of sides, a grid usually looks better than a few straight cuts.",[199,2117,2118,2121,2129,2134],{},[113,2119,2120],{},"Select the n-gon face.",[113,2122,85,2123,2125,2126,2128],{},[67,2124,825],{}," and choose ",[16,2127,1561],{},". This removes the face and keeps its edges.",[113,2130,2131,2132,220],{},"Select one edge of the opening and choose ",[16,2133,283],{},[113,2135,42,2136,312,2138,2140],{},[16,2137,276],{},[67,2139,1443],{},", then Grid Fill).",[12,2142,2143,2144,2147],{},"Two 8-sided n-gons (a 2 by 2 block and an L shape of three quads) were filled this way and both came out as quads only, four new quads each. As with any hole, an odd number of edges fails with a Grid Fill message and nothing changes. ",[286,2145,2146],{"href":288},"The hole-filling guide"," explains the odd-loop workaround.",[36,2149,2151],{"id":2150},"step-5-triangulate-first-then-altj-only-for-small-n-gons","Step 5: triangulate first, then Alt+J, only for small n-gons",[12,2153,2154,2155,54,2158,2161,2162,2164],{},"Triangulating an n-gon (",[16,2156,2157],{},"Face > Triangulate Faces",[67,2159,2160],{},"Ctrl+T",") and then pressing ",[67,2163,319],{}," is the lazy route. In my test the 12-sided n-gon became 10 triangles, and Alt+J turned only two pairs into quads, leaving 6 triangles. It is acceptable for a tiny n-gon in a place nobody sees, not a way to clean up topology.",[36,2166,2168],{"id":2167},"when-n-gons-are-fine","When n-gons are fine",[12,2170,2171,2172,2175],{},"N-gons are not an error. A flat n-gon on a hard-surface model that will not be deformed or subdivided shades correctly and can stay as it is. Convert them where they sit on a curved surface, where the mesh will be animated or subdivided, or where they cause shading problems. QuadFix's ",[16,2173,2174],{},"Keep Planar N-gons"," option works on the same idea.",[36,2177,2179],{"id":2178},"why-not-remesh-everything","Why not remesh everything?",[12,2181,2182,2183,2186,2187,2190,2191,2194,2195,2198],{},"Blender can rebuild a mesh as quads for you: select the object, open the ",[16,2184,2185],{},"Object Data"," properties tab, open the ",[16,2188,2189],{},"Remesh"," panel, set ",[16,2192,2193],{},"Mode"," to Quad and press ",[16,2196,2197],{},"QuadriFlow Remesh",". Tested on a UV sphere (240 quads, 48 triangles at the poles), it returned only quads. The catches:",[110,2200,2201,2204,2207],{},[113,2202,2203],{},"It ignores your topology. The face count follows the target you set, not the mesh you had. A target of 500 faces gave 598 in my test.",[113,2205,2206],{},"Your loops, UV layout and vertex positions are gone, because it is a new mesh.",[113,2208,2209],{},"It does not close holes. A sphere with a hole stayed open after the remesh.",[36,2211,1566],{"id":1565},[355,2213,2214,2226],{},[358,2215,2216],{},[361,2217,2218,2221,2223],{},[364,2219,2220],{},"Situation",[364,2222,1166],{},[364,2224,2225],{},"What you get",[377,2227,2228,2240,2253,2266,2277,2288],{},[361,2229,2230,2233,2237],{},[382,2231,2232],{},"Triangles that came from triangulating quads",[382,2234,2235],{},[67,2236,319],{},[382,2238,2239],{},"Mostly clean quads",[361,2241,2242,2245,2250],{},[382,2243,2244],{},"Triangles on a noisy or scanned surface",[382,2246,2247,2249],{},[67,2248,319],{}," with larger angles",[382,2251,2252],{},"More quads, less regular shapes",[361,2254,2255,2258,2263],{},[382,2256,2257],{},"One n-gon with an even number of sides",[382,2259,2260,2262],{},[67,2261,1846],{}," repeatedly",[382,2264,2265],{},"(n minus 2) divided by 2 quads",[361,2267,2268,2271,2274],{},[382,2269,2270],{},"A big even n-gon",[382,2272,2273],{},"Delete face, then Grid Fill",[382,2275,2276],{},"A grid of quads",[361,2278,2279,2282,2285],{},[382,2280,2281],{},"An odd n-gon",[382,2283,2284],{},"Add a vertex, then cut or Grid Fill",[382,2286,2287],{},"A leftover n-gon next to the patch",[361,2289,2290,2293,2295],{},[382,2291,2292],{},"A whole model to rebuild",[382,2294,2197],{},[382,2296,2297],{},"All quads, new topology",[36,2299,453],{"id":452},[110,2301,2302,2308,2314],{},[113,2303,2304,2307],{},[16,2305,2306],{},"Alt+J joins nothing."," Check the Compare options and any seam or sharp marks, or raise the angles.",[113,2309,2310,2313],{},[16,2311,2312],{},"The result is skewed or wavy."," The angles are too large. Go back to 40 degrees and accept a few triangles.",[113,2315,2316,2319,2320,220],{},[16,2317,2318],{},"Selection looks right but nothing happens."," The mesh may have unwelded vertices, so neighbouring faces are not really connected. See ",[286,2321,2322],{"href":596},"cleaning up an imported mesh",[36,2324,488],{"id":487},[12,2326,2327,2329,2330,220],{},[286,2328,494],{"href":493}," puts triangles and n-gons into one button, ",[16,2331,2332],{},"N-gons to Quads",[199,2334,2335,2342,2347,2352],{},[113,2336,2337,2338,509,2340,1707],{},"In Edit Mode open the ",[16,2339,494],{},[67,2341,512],{},[113,2343,85,2344,2346],{},[16,2345,516],{}," to see what is wrong. The panel prints the number of non-quad faces and boundary edges.",[113,2348,2349,2350,220],{},"Select the area or the whole mesh and press ",[16,2351,2332],{},[113,2353,2354],{},"Read the report line: it shows n-gons, triangles and quads before and after.",[12,2356,2357],{},"What my tests showed on Blender 4.2.23 and 5.2.2:",[110,2359,2360,2366,2374],{},[113,2361,2362,2365],{},[16,2363,2364],{},"Curved n-gons are converted along with triangles."," A curved 8-sided n-gon on a bowl-shaped surface was replaced with four quads and the report showed n-gons going from 1 to 0.",[113,2367,2368,312,2371,2373],{},[16,2369,2370],{},"Flat n-gons are left alone by default",[16,2372,2174],{},"), so clean CAD faces are not touched. On a flat 8-gon the button reported there was nothing to convert. Turn the option off and the same n-gon was converted to quads.",[113,2375,2376,2379,2380,2383],{},[16,2377,2378],{},"The default angles are 90 degrees."," On the nudged sphere above, the defaults left 42 triangles in 5.2.2 (52 in 4.2.23, again the same as Alt+J at 90). ",[16,2381,2382],{},"Aggressive Quads"," brought it to 28, the same as Alt+J at 180. So the angle settings are not magic, the gain is having n-gons, triangles and the report in a single step.",[12,2385,2386,2387,2389,2390,2392],{},"QuadFix repairs the mesh you have and is not a retopology tool: some leftover triangles on irregular scans are unavoidable, and it shows them instead of hiding them. All options are in the ",[286,2388,554],{"href":553},", and the ",[286,2391,559],{"href":558}," walks through typical repairs. The free QuadFix Lite includes N-gons to Quads and the cleanup button.",[36,2394,564],{"id":563},[110,2396,2397,2401],{},[113,2398,2399],{},[286,2400,289],{"href":288},[113,2402,2403],{},[286,2404,1811],{"href":596},{"title":577,"searchDepth":578,"depth":578,"links":2406},[2407,2408,2411,2412,2413,2414,2415,2416,2417,2418,2419],{"id":1873,"depth":578,"text":1874},{"id":1922,"depth":578,"text":1923,"children":2409},[2410],{"id":1946,"depth":968,"text":1947},{"id":2074,"depth":578,"text":2075},{"id":2111,"depth":578,"text":2112},{"id":2150,"depth":578,"text":2151},{"id":2167,"depth":578,"text":2168},{"id":2178,"depth":578,"text":2179},{"id":1565,"depth":578,"text":1566},{"id":452,"depth":578,"text":453},{"id":487,"depth":578,"text":488},{"id":563,"depth":578,"text":564},"Convert n-gons and triangles to quads in Blender with Faces by Sides, Tris to Quads (Alt+J), Connect Vertex Path and Grid Fill, and learn where each one stops.",{},"---\ntitle: \"Convert n-gons and tris to quads in Blender\"\ndescription: \"Convert n-gons and triangles to quads in Blender with Faces by Sides, Tris to Quads (Alt+J), Connect Vertex Path and Grid Fill, and learn where each one stops.\"\naddon: quadfix\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nupdated: 2026-11-16\n---\n\nTo turn an n-gon into quads in Blender, cut it with **Connect Vertex Path** (`J`) between two vertices three steps apart, or delete the face (`X` > **Only Faces**) and refill the opening with **Face > Grid Fill**. Both need an even number of sides. For triangles, select them and press `Alt+J` (**Face > Tris to Quads**), which joins neighbouring pairs but ignores n-gons. No built-in tool does both in one go.\n\nI tested every result below in Blender 4.2.23 and 5.2.2 on small test meshes, so the numbers are from real runs. Shortcuts use Ctrl and Alt: on a Mac that means the Control and Option keys. In Blender 5.x the menu entry is called **Triangles to Quads**, in 4.2 it is **Tris to Quads**. It is the same operator with the same shortcut.\n\n## Step 1: find the faces that are not quads\n\n1. Press `Tab` for Edit Mode and press `3` for face select mode.\n2. Choose **Select > Select All by Trait > Faces by Sides**.\n3. In the Adjust Last Operation panel set **Number of Vertices** to 4 and **Type** to **Not Equal To**. This selects every triangle and every n-gon.\n4. Turn on **Overlays > Statistics** to see how many faces are selected.\n\nOn a test grid with one 12-sided n-gon and 16 triangles, Not Equal To selected 17 faces. Type **Greater Than** with 4 selected only the n-gon, and **Less Than** with 4 selected only the 16 triangles. Use those two to treat triangles and n-gons separately, because they need different tools.\n\n## Step 2: triangles to quads with Alt+J\n\n1. Select the triangles (or the whole mesh) in Edit Mode.\n2. Press `Alt+J`, or choose **Face > Tris to Quads**.\n3. Open **Adjust Last Operation** and tune the options.\n\nWhen a triangulated quad is simply sitting there, it rejoins cleanly. In my test grid the 16 triangles became 8 quads and none were left. The 12-sided n-gon was left untouched, because this operator only looks at triangles.\n\n### The options that matter\n\n| Option | Default | What it does |\n| --- | --- | --- |\n| Max Face Angle | 40 degrees | How different the two triangle normals may be |\n| Max Shape Angle | 40 degrees | How far the joined quad may be from a rectangle |\n| Compare UVs, Color Attributes, Seam, Sharp, Materials | off | When on, triangles are not joined across a UV border, seam, sharp edge or material boundary |\n\nThe two angle values decide how many triangles survive. On a triangulated UV sphere with its vertices randomly nudged (528 triangles to start), Blender 5.2.2 gave:\n\n| Both angles | Triangles left | Quads |\n| --- | --- | --- |\n| 10 degrees | 512 | 8 |\n| 40 degrees (default) | 182 | 173 |\n| 90 degrees | 42 | 243 |\n| 180 degrees | 28 | 250 |\n\nBlender 4.2.23 gave slightly different counts on the same mesh but the same trend. Higher angles join more pairs, and the quads get less regular. The Compare options work as blockers: with every edge marked as a seam and **Compare Seam** on, no triangle was joined at all, and the same happened with every edge sharp and **Compare Sharp** on. If Alt+J does nothing on your mesh, look for a Compare option left on, or for edges marked as seams or sharp.\n\n## Step 3: split an n-gon with Connect Vertex Path (J)\n\nAn n-gon can only be cut into quads if its number of sides is even: an n-gon with n sides makes (n minus 2) divided by 2 quads. So an 8-gon gives 3 quads and a 6-gon gives 2. An n-gon with an odd number of sides cannot be cut into only quads unless you add a vertex.\n\n1. Press `1` for vertex select mode.\n2. Click one vertex of the n-gon, then click the vertex three steps further along its outline, so the cut separates a piece with four corners.\n3. Choose **Vertex > Connect Vertex Path** or press `J`.\n4. Repeat on the remaining n-gon until only quads are left.\n\nBlender uses the order in which you selected the vertices, so click them one after the other instead of box-selecting. In my test an 8-sided n-gon was cut once, which gave a quad and a 6-sided n-gon. Cutting the 6-gon once more gave two quads. Three quads in total, no triangles.\n\n> A cut in the wrong place leaves two smaller n-gons instead of quads. Count the steps between your two picks before pressing `J`.\n\n## Step 4: delete the n-gon and Grid Fill it\n\nFor a large n-gon with an even number of sides, a grid usually looks better than a few straight cuts.\n\n1. Select the n-gon face.\n2. Press `X` and choose **Only Faces**. This removes the face and keeps its edges.\n3. Select one edge of the opening and choose **Select > Select Loops > Edge Loops**.\n4. Choose **Face > Grid Fill** (`Ctrl+F`, then Grid Fill).\n\nTwo 8-sided n-gons (a 2 by 2 block and an L shape of three quads) were filled this way and both came out as quads only, four new quads each. As with any hole, an odd number of edges fails with a Grid Fill message and nothing changes. [The hole-filling guide](\u002Fguides\u002Ffill-hole-with-quads) explains the odd-loop workaround.\n\n## Step 5: triangulate first, then Alt+J, only for small n-gons\n\nTriangulating an n-gon (**Face > Triangulate Faces**, `Ctrl+T`) and then pressing `Alt+J` is the lazy route. In my test the 12-sided n-gon became 10 triangles, and Alt+J turned only two pairs into quads, leaving 6 triangles. It is acceptable for a tiny n-gon in a place nobody sees, not a way to clean up topology.\n\n## When n-gons are fine\n\nN-gons are not an error. A flat n-gon on a hard-surface model that will not be deformed or subdivided shades correctly and can stay as it is. Convert them where they sit on a curved surface, where the mesh will be animated or subdivided, or where they cause shading problems. QuadFix's **Keep Planar N-gons** option works on the same idea.\n\n## Why not remesh everything?\n\nBlender can rebuild a mesh as quads for you: select the object, open the **Object Data** properties tab, open the **Remesh** panel, set **Mode** to Quad and press **QuadriFlow Remesh**. Tested on a UV sphere (240 quads, 48 triangles at the poles), it returned only quads. The catches:\n\n- It ignores your topology. The face count follows the target you set, not the mesh you had. A target of 500 faces gave 598 in my test.\n- Your loops, UV layout and vertex positions are gone, because it is a new mesh.\n- It does not close holes. A sphere with a hole stayed open after the remesh.\n\n## Which method to use\n\n| Situation | Method | What you get |\n| --- | --- | --- |\n| Triangles that came from triangulating quads | `Alt+J` | Mostly clean quads |\n| Triangles on a noisy or scanned surface | `Alt+J` with larger angles | More quads, less regular shapes |\n| One n-gon with an even number of sides | `J` repeatedly | (n minus 2) divided by 2 quads |\n| A big even n-gon | Delete face, then Grid Fill | A grid of quads |\n| An odd n-gon | Add a vertex, then cut or Grid Fill | A leftover n-gon next to the patch |\n| A whole model to rebuild | QuadriFlow Remesh | All quads, new topology |\n\n## What can go wrong\n\n- **Alt+J joins nothing.** Check the Compare options and any seam or sharp marks, or raise the angles.\n- **The result is skewed or wavy.** The angles are too large. Go back to 40 degrees and accept a few triangles.\n- **Selection looks right but nothing happens.** The mesh may have unwelded vertices, so neighbouring faces are not really connected. See [cleaning up an imported mesh](\u002Fguides\u002Fclean-up-imported-stl).\n\n## Faster with QuadFix\n\n[QuadFix](\u002Faddons\u002Fquadfix) puts triangles and n-gons into one button, **N-gons to Quads**.\n\n1. In Edit Mode open the **QuadFix** tab in the sidebar (`N`).\n2. Press **Select Non-Quads & Holes** to see what is wrong. The panel prints the number of non-quad faces and boundary edges.\n3. Select the area or the whole mesh and press **N-gons to Quads**.\n4. Read the report line: it shows n-gons, triangles and quads before and after.\n\nWhat my tests showed on Blender 4.2.23 and 5.2.2:\n\n- **Curved n-gons are converted along with triangles.** A curved 8-sided n-gon on a bowl-shaped surface was replaced with four quads and the report showed n-gons going from 1 to 0.\n- **Flat n-gons are left alone by default** (**Keep Planar N-gons**), so clean CAD faces are not touched. On a flat 8-gon the button reported there was nothing to convert. Turn the option off and the same n-gon was converted to quads.\n- **The default angles are 90 degrees.** On the nudged sphere above, the defaults left 42 triangles in 5.2.2 (52 in 4.2.23, again the same as Alt+J at 90). **Aggressive Quads** brought it to 28, the same as Alt+J at 180. So the angle settings are not magic, the gain is having n-gons, triangles and the report in a single step.\n\nQuadFix repairs the mesh you have and is not a retopology tool: some leftover triangles on irregular scans are unavoidable, and it shows them instead of hiding them. All options are in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel), and the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows) walks through typical repairs. The free QuadFix Lite includes N-gons to Quads and the cleanup button.\n\n## Related guides\n\n- [How to fill a hole with quads in Blender](\u002Fguides\u002Ffill-hole-with-quads)\n- [How to clean up an imported STL or OBJ mesh in Blender](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":1835,"description":2420},"guides\u002Fngons-to-quads","LqiKPhIwJM22DyYIZpSnJu8dZDYIfXpJ_e9Q9mIHvSE",{"id":2427,"title":2428,"addon":2429,"body":2430,"description":3051,"extension":593,"meta":3052,"navigation":595,"path":3053,"poster":3054,"rawbody":3055,"seo":3056,"stem":3057,"updated":601,"video":3058,"__hash__":3059},"guides\u002Fguides\u002Fsplit-model-for-3d-printing.md","Split a model for 3D printing in Blender","bedsplit",{"type":9,"value":2431,"toc":3037},[2432,2443,2447,2494,2500,2511,2515,2518,2566,2575,2587,2591,2594,2654,2671,2674,2685,2689,2695,2717,2723,2727,2730,2748,2751,2755,2758,2779,2783,2796,2800,2803,2821,2828,2832,2854,2860,2862,2894,2896,2965,2969,2977,3024,3031,3034],[12,2433,2434,2435,2438,2439,2442],{},"To split a model for 3D printing in Blender, check its size in millimetres first, then cut it into parts with ",[16,2436,2437],{},"Mesh > Bisect"," (with ",[16,2440,2441],{},"Fill"," on) or with a Boolean modifier and a cutter cube, make sure every part is a closed solid, and export the parts as STL files. Add pin sockets if the parts have to line up when you glue them. I ran each step below on a test mesh in Blender 4.2, 4.5 and 5.2, and checked the result for open edges.",[36,2444,2446],{"id":2445},"step-1-check-the-size-against-your-bed","Step 1: check the size against your bed",[199,2448,2449,2477,2491],{},[113,2450,1451,2451,901,2454,2457,2458,697,2461,54,2464,697,2467,145,2470,697,2473,2476],{},[16,2452,2453],{},"Scene Properties",[16,2455,2456],{},"Units"," panel. Set ",[16,2459,2460],{},"Unit System",[16,2462,2463],{},"Metric",[16,2465,2466],{},"Unit Scale",[67,2468,2469],{},"0.001",[16,2471,2472],{},"Length",[16,2474,2475],{},"Millimeters",". Now one Blender unit is one millimetre.",[113,2478,2479,2480,2482,2483,2486,2487,2490],{},"Select the model, press ",[16,2481,512],{}," and open the ",[16,2484,2485],{},"Item"," tab. ",[16,2488,2489],{},"Dimensions"," shows the size. These values include object scale.",[113,2492,2493],{},"Compare each side with your printer's build volume. Height is a limit too.",[12,2495,2496,2497,2499],{},"This also matters for export. With default settings the STL exporter writes the plain Blender-unit numbers and ignores the Unit Scale (its ",[16,2498,57],{}," option is off). In my test a cube at 10 units went into the file as 10. Slicers read STL numbers as millimetres, so with this unit setup the file matches what you saw.",[12,2501,2502,2503,2506,2507,2510],{},"If the model needs resizing, scale it (",[16,2504,2505],{},"S",") and apply the scale (",[16,2508,2509],{},"Ctrl A > Scale","), so later cuts and exports use the real numbers.",[36,2512,2514],{"id":2513},"step-2-cut-with-bisect","Step 2: cut with Bisect",[12,2516,2517],{},"Bisect cuts a mesh along one plane and can close the cut for you.",[199,2519,2520,2528,2533,2552],{},[113,2521,2479,2522,2524,2525,2527],{},[16,2523,69],{}," for Edit Mode, and press ",[16,2526,73],{}," to select everything.",[113,2529,42,2530,2532],{},[16,2531,2437],{}," (the toolbar has a Bisect tool too). Drag a line across the model in the viewport to place the plane.",[113,2534,1451,2535,2537,2538,145,2541,2544,2545,145,2548,2551],{},[16,2536,1454],{}," panel in the bottom-left corner and type the ",[16,2539,2540],{},"Plane Point",[16,2542,2543],{},"Plane Normal",", for example ",[67,2546,2547],{},"0, 0, 120",[67,2549,2550],{},"0, 0, 1"," for a flat cut at 120 mm height.",[113,2553,2554,2555,2557,2558,2561,2562,2565],{},"Switch on ",[16,2556,2441],{},". Switch on ",[16,2559,2560],{},"Clear Inner"," to delete the part on the side opposite the plane normal, or ",[16,2563,2564],{},"Clear Outer"," for the other side.",[12,2567,2568,2569,2571,2572,2574],{},"Fill matters. In my test a sphere cut without ",[16,2570,2441],{}," had 32 open boundary edges, and with ",[16,2573,2441],{}," it had none. Fill covers the cut with a single flat face, so the half is a closed solid.",[12,2576,2577,2578,2580,2581,2583,2584,2586],{},"To keep both halves, duplicate the object first (",[16,2579,671],{},", then right-click to cancel the move). Cut one copy with ",[16,2582,2560],{}," and the other with ",[16,2585,2564],{},", same plane. In my test the two halves added up to the volume of the original (4.1219 cubic units against 2.3700 plus 1.7519).",[36,2588,2590],{"id":2589},"step-3-cut-with-a-boolean-and-a-cutter-cube","Step 3: cut with a Boolean and a cutter cube",[12,2592,2593],{},"A Boolean suits cuts you want to move or repeat, because the cutter stays a normal object.",[199,2595,2596,2603,2609,2638,2645],{},[113,2597,2598,2599,2602],{},"Add a cube (",[16,2600,2601],{},"Shift A > Mesh > Cube",") and scale it so one face lies exactly on the cut position and the cube covers everything on one side of it. This is your cutter.",[113,2604,2605,2606,2608],{},"Duplicate the model (",[16,2607,671],{},"). You will have two copies.",[113,2610,2611,2612,2615,2616,2619,2620,697,2623,54,2626,697,2629,2631,2632,697,2635,220],{},"On the first copy open the ",[16,2613,2614],{},"Modifiers"," tab and choose ",[16,2617,2618],{},"Add Modifier > Generate > Boolean",". Set ",[16,2621,2622],{},"Operation",[16,2624,2625],{},"Difference",[16,2627,2628],{},"Operand Type",[16,2630,931],{},", and pick the cutter. Set ",[16,2633,2634],{},"Solver",[16,2636,2637],{},"Exact",[113,2639,2640,2641,2644],{},"Apply the modifier with ",[16,2642,2643],{},"Ctrl A"," while hovering over it.",[113,2646,2647,2648,1037,2650,2653],{},"On the second copy add the same modifier with ",[16,2649,2622],{},[16,2651,2652],{},"Intersect"," and apply it.",[12,2655,2656,2657,2660,2661,2664,2665,2667,2668,2670],{},"In 4.2 the other solver is called ",[16,2658,2659],{},"Fast","; 4.5 adds ",[16,2662,2663],{},"Manifold",", and in 5.x Fast is renamed ",[16,2666,916],{},". Fast\u002FFloat gave the same closed halves on a clean sphere in my test; Manifold was not tested. Start with ",[16,2669,2637],{},". Hide the cutter when both are applied.",[12,2672,2673],{},"Difference keeps what the cutter does not cover, Intersect keeps what it does. My two test halves again added up to the volume of the original, and both were closed.",[1061,2675,2676],{},[12,2677,2678,2679,2681,2682,220],{},"A Boolean needs the model itself to be closed. If it fails or leaves holes, find the problem with ",[16,2680,215],{}," (Edit Mode) and see ",[286,2683,2684],{"href":596},"how to clean up an imported STL",[36,2686,2688],{"id":2687},"step-4-make-the-cut-face-solid","Step 4: make the cut face solid",[12,2690,2691,2692,2694],{},"A Boolean closes the cut for you. If you cut with Bisect and left ",[16,2693,2441],{}," off, or you deleted faces by hand, close it yourself:",[199,2696,2697,2703,2708],{},[113,2698,2699,2700,2702],{},"In Edit Mode choose ",[16,2701,215],{},". The open edge loop of the cut is selected (32 edges in my test).",[113,2704,85,2705,2707],{},[16,2706,270],{}," to fill it. The result is closed, with one large flat face.",[113,2709,2710,2711,2713,2714,2716],{},"For quads on the cut face, choose ",[16,2712,276],{}," instead. It worked on the same loop and gave a closed result too. ",[16,2715,270],{}," leaves one n-gon, which is fine for printing.",[12,2718,2719,2720,220],{},"For holes that are not a flat loop, see ",[286,2721,2722],{"href":288},"how to fill a hole with quads",[36,2724,2726],{"id":2725},"step-5-add-pin-sockets-so-the-parts-line-up","Step 5: add pin sockets so the parts line up",[12,2728,2729],{},"Glued flat faces slide against each other. Round pins and sockets fix that.",[199,2731,2732,2739,2745],{},[113,2733,2734,2735,2738],{},"Add a cylinder (",[16,2736,2737],{},"Shift A > Mesh > Cylinder",") for the socket: a radius a little bigger than the pin, and a length that reaches into both halves. Centre it on the cut plane.",[113,2740,2741,2742,2744],{},"Apply a Boolean ",[16,2743,2625],{}," with the cylinder as operand to the lower half, and again to the upper half. The same cylinder cuts a socket in both.",[113,2746,2747],{},"Model a pin as a second cylinder, a bit smaller than the socket, as long as the two socket depths together. Print it separately.",[12,2749,2750],{},"In my test both halves got the socket and stayed closed. A printed pin needs clearance. For example, a 6 mm pin in a 6.4 mm socket leaves 0.2 mm each side (my test used radii of 0.30 and 0.32 units). Printers differ, so print one pair first. Keep sockets away from the outline, where they would leave a paper-thin wall.",[36,2752,2754],{"id":2753},"step-6-separate-loose-parts","Step 6: separate loose parts",[12,2756,2757],{},"If a cut leaves several pieces in one object, split them into objects. In my test a Boolean Difference with a thin slab through a sphere left two floating halves in one mesh.",[199,2759,2760,2776],{},[113,2761,2762,2763,2765,2766,2125,2769,2772,2773,220],{},"In Edit Mode press ",[16,2764,73],{},", then ",[16,2767,2768],{},"P",[16,2770,2771],{},"By Loose Parts",". The path is ",[16,2774,2775],{},"Mesh > Separate > By Loose Parts",[113,2777,2778],{},"Back in Object Mode each piece is its own object. Both pieces were closed in my test.",[36,2780,2782],{"id":2781},"cuts-that-are-not-flat","Cuts that are not flat",[12,2784,2785,2786,312,2789,2792,2793,2795],{},"Bisect and a cutter cube make flat cuts. For a curved dividing line, select the faces on one side in Edit Mode and press ",[16,2787,2788],{},"P > Selection",[16,2790,2791],{},"Mesh > Separate > Selection","). In my test I selected a wavy band of faces on a UV sphere (the dividing line followed z = 0.25 sin 3x) and separated it. That gave two objects of 256 faces each, both open along a 40-edge boundary. Pressing ",[16,2794,270],{}," on each boundary loop closed both parts with a single 40-sided face. The two cut faces are not flat, so they will not sit flush against each other, and you have to check the fit and the walls yourself. BedSplit below only cuts flat planes.",[36,2797,2799],{"id":2798},"step-7-check-every-part","Step 7: check every part",[12,2801,2802],{},"Check each part before you slice it. The built-in way:",[199,2804,2805,2810],{},[113,2806,2699,2807,2809],{},[16,2808,215],{},". Nothing should be selected. Anything selected is an open edge or a bad vertex.",[113,2811,1383,2812,2814,2815,2817,2818,2820],{},[16,2813,77],{}," to see face and vertex counts, and check the ",[16,2816,2489],{}," of each part in the ",[16,2819,2485],{}," tab against the bed.",[12,2822,2823,2824,2827],{},"The 3D-Print Toolbox is the usual extra check. Since Blender 4.2 it is an extension, installed from ",[16,2825,2826],{},"Edit > Preferences > Get Extensions",". I did not test it, so this guide uses the built-in selection.",[36,2829,2831],{"id":2830},"step-8-export-only-the-parts","Step 8: export only the parts",[199,2833,2834,2840],{},[113,2835,2836,2837,220],{},"Select the parts you want. In Blender 4.2 and later, choose ",[16,2838,2839],{},"File > Export > STL (.stl)",[113,2841,2842,2843,2846,2847,2849,2850,2853],{},"On the right of the file window switch on ",[16,2844,2845],{},"Export Selected Objects",". Leave ",[16,2848,57],{}," off, as explained in step 1, and decide about ",[16,2851,2852],{},"Apply Modifiers",". If you did not apply your Boolean modifiers, switch it on.",[12,2855,2856,2857,2859],{},"In my test, with ",[16,2858,2845],{}," on, only the selected cube was in the file, 12 triangles, and with it off both cubes were, 24 triangles.",[36,2861,1117],{"id":1116},[110,2863,2864,2870,2876,2882,2888],{},[113,2865,2866,2869],{},[16,2867,2868],{},"The cut leaves a hole."," Fill was off, or the model was not closed. Use steps 4 and 7.",[113,2871,2872,2875],{},[16,2873,2874],{},"The two halves overlap or leave a gap."," The Bisect plane and the cutter face are not on the same plane. Type the plane numbers.",[113,2877,2878,2881],{},[16,2879,2880],{},"The model prints at the wrong size."," The unit setup in step 1 was skipped.",[113,2883,2884,2887],{},[16,2885,2886],{},"The part is still too big."," Cut again along another axis. Every cut means more fill, sockets and checks.",[113,2889,1149,2890,220],{},[286,2891,2893],{"href":2892},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting","BedSplit troubleshooting page",[36,2895,1157],{"id":1156},[355,2897,2898,2908],{},[358,2899,2900],{},[361,2901,2902,2904,2906],{},[364,2903,1166],{},[364,2905,1169],{},[364,2907,1172],{},[377,2909,2910,2921,2932,2943,2954],{},[361,2911,2912,2915,2918],{},[382,2913,2914],{},"Bisect with Fill",[382,2916,2917],{},"One flat cut, fast",[382,2919,2920],{},"Many cuts, or sockets by hand",[361,2922,2923,2926,2929],{},[382,2924,2925],{},"Boolean with a cutter cube",[382,2927,2928],{},"Cut shapes you control, repeatable",[382,2930,2931],{},"Mesh is not closed",[361,2933,2934,2937,2940],{},[382,2935,2936],{},"Grid Fill or F on the cut",[382,2938,2939],{},"Fixing a cut left open",[382,2941,2942],{},"The cut is not a flat loop",[361,2944,2945,2948,2951],{},[382,2946,2947],{},"Cylinder Boolean for pins",[382,2949,2950],{},"Alignment between parts",[382,2952,2953],{},"You need dozens of joints",[361,2955,2956,2959,2962],{},[382,2957,2958],{},"Separate by Loose Parts",[382,2960,2961],{},"Splitting one object into objects",[382,2963,2964],{},"Parts touch each other",[36,2966,2968],{"id":2967},"faster-with-bedsplit","Faster with BedSplit",[12,2970,2971,2972,2976],{},"With many cuts, the manual route repeats the chain above for every joint. ",[286,2973,2975],{"href":2974},"\u002Faddons\u002Fbedsplit","BedSplit"," does it for you:",[110,2978,2979,2992,2998,3007,3010,3021],{},[113,2980,2981,2982,2984,2985,2987,2988,2991],{},"Pick your printer in the ",[16,2983,2975],{}," tab of the sidebar (",[16,2986,512],{},"), or choose ",[16,2989,2990],{},"Custom"," and type the bed size. It has presets for Bambu Lab, Prusa, Creality, Anycubic, Elegoo, Sovol and Voron machines.",[113,2993,1383,2994,2997],{},[16,2995,2996],{},"Resize for print"," and enter the longest side in millimetres, so you do not set up units.",[113,2999,85,3000,3003,3004,220],{},[16,3001,3002],{},"Find Cuts"," to see the cut planes in the viewport, move or remove a plane, or add one with the X, Y or Z buttons, then press ",[16,3005,3006],{},"Split to Bed",[113,3008,3009],{},"Each joint gets round dowel sockets in both faces, and you set the diameter, depth, clearance and the dowels per joint. A socket is only placed where the wall is thick enough.",[113,3011,3012,3013,3016,3017,3020],{},"Each part is turned flat on its cut face, the ",[16,3014,3015],{},"Result"," panel lists every part with its size and whether it fits and is closed, and ",[16,3018,3019],{},"Export STL"," writes one file per part in millimetres, plus the dowel.",[113,3022,3023],{},"Holes, flipped normals and overlapping shells are repaired first. The parts are new objects and your original stays.",[12,3025,3026,3027,220],{},"Its limits: the cuts are flat planes along X, Y and Z (you can move them, not rotate them), the dowels are round, and there is no hollowing or supports. It works in Blender 4.2 and newer. The steps are in the ",[286,3028,3030],{"href":3029},"\u002Fdocs\u002Fbedsplit\u002Fworkflows","BedSplit workflows",[12,3032,3033],{},"The free BedSplit Lite splits a watertight model to your bed with flat cuts and exports one STL per part, without dowels, mesh repair or the cut preview.",[12,3035,3036],{},"For one or two cuts, the manual methods above are enough.",{"title":577,"searchDepth":578,"depth":578,"links":3038},[3039,3040,3041,3042,3043,3044,3045,3046,3047,3048,3049,3050],{"id":2445,"depth":578,"text":2446},{"id":2513,"depth":578,"text":2514},{"id":2589,"depth":578,"text":2590},{"id":2687,"depth":578,"text":2688},{"id":2725,"depth":578,"text":2726},{"id":2753,"depth":578,"text":2754},{"id":2781,"depth":578,"text":2782},{"id":2798,"depth":578,"text":2799},{"id":2830,"depth":578,"text":2831},{"id":1116,"depth":578,"text":1117},{"id":1156,"depth":578,"text":1157},{"id":2967,"depth":578,"text":2968},"Split a model that is too big for your print bed in Blender: Bisect with Fill, Boolean cuts, closed cut faces, pin sockets and one STL per part, all tested.",{},"\u002Fguides\u002Fsplit-model-for-3d-printing","\u002Fmedia\u002Fbedsplit.jpg","---\ntitle: \"Split a model for 3D printing in Blender\"\ndescription: \"Split a model that is too big for your print bed in Blender: Bisect with Fill, Boolean cuts, closed cut faces, pin sockets and one STL per part, all tested.\"\naddon: bedsplit\nvideo: \u002Fmedia\u002Fbedsplit.mp4\nposter: \u002Fmedia\u002Fbedsplit.jpg\nupdated: 2026-11-16\n---\n\nTo split a model for 3D printing in Blender, check its size in millimetres first, then cut it into parts with **Mesh > Bisect** (with **Fill** on) or with a Boolean modifier and a cutter cube, make sure every part is a closed solid, and export the parts as STL files. Add pin sockets if the parts have to line up when you glue them. I ran each step below on a test mesh in Blender 4.2, 4.5 and 5.2, and checked the result for open edges.\n\n## Step 1: check the size against your bed\n\n1. Open the **Scene Properties** tab, **Units** panel. Set **Unit System** to **Metric**, **Unit Scale** to `0.001` and **Length** to **Millimeters**. Now one Blender unit is one millimetre.\n2. Select the model, press **N** and open the **Item** tab. **Dimensions** shows the size. These values include object scale.\n3. Compare each side with your printer's build volume. Height is a limit too.\n\nThis also matters for export. With default settings the STL exporter writes the plain Blender-unit numbers and ignores the Unit Scale (its **Scene Unit** option is off). In my test a cube at 10 units went into the file as 10. Slicers read STL numbers as millimetres, so with this unit setup the file matches what you saw.\n\nIf the model needs resizing, scale it (**S**) and apply the scale (**Ctrl A > Scale**), so later cuts and exports use the real numbers.\n\n## Step 2: cut with Bisect\n\nBisect cuts a mesh along one plane and can close the cut for you.\n\n1. Select the model, press **Tab** for Edit Mode, and press **A** to select everything.\n2. Choose **Mesh > Bisect** (the toolbar has a Bisect tool too). Drag a line across the model in the viewport to place the plane.\n3. Open the **Adjust Last Operation** panel in the bottom-left corner and type the **Plane Point** and **Plane Normal**, for example `0, 0, 120` and `0, 0, 1` for a flat cut at 120 mm height.\n4. Switch on **Fill**. Switch on **Clear Inner** to delete the part on the side opposite the plane normal, or **Clear Outer** for the other side.\n\nFill matters. In my test a sphere cut without **Fill** had 32 open boundary edges, and with **Fill** it had none. Fill covers the cut with a single flat face, so the half is a closed solid.\n\nTo keep both halves, duplicate the object first (**Shift D**, then right-click to cancel the move). Cut one copy with **Clear Inner** and the other with **Clear Outer**, same plane. In my test the two halves added up to the volume of the original (4.1219 cubic units against 2.3700 plus 1.7519).\n\n## Step 3: cut with a Boolean and a cutter cube\n\nA Boolean suits cuts you want to move or repeat, because the cutter stays a normal object.\n\n1. Add a cube (**Shift A > Mesh > Cube**) and scale it so one face lies exactly on the cut position and the cube covers everything on one side of it. This is your cutter.\n2. Duplicate the model (**Shift D**). You will have two copies.\n3. On the first copy open the **Modifiers** tab and choose **Add Modifier > Generate > Boolean**. Set **Operation** to **Difference**, **Operand Type** to **Object**, and pick the cutter. Set **Solver** to **Exact**.\n4. Apply the modifier with **Ctrl A** while hovering over it.\n5. On the second copy add the same modifier with **Operation** set to **Intersect** and apply it.\n\nIn 4.2 the other solver is called **Fast**; 4.5 adds **Manifold**, and in 5.x Fast is renamed **Float**. Fast\u002FFloat gave the same closed halves on a clean sphere in my test; Manifold was not tested. Start with **Exact**. Hide the cutter when both are applied.\n\nDifference keeps what the cutter does not cover, Intersect keeps what it does. My two test halves again added up to the volume of the original, and both were closed.\n\n> A Boolean needs the model itself to be closed. If it fails or leaves holes, find the problem with **Select > Select All by Trait > Non Manifold** (Edit Mode) and see [how to clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl).\n\n## Step 4: make the cut face solid\n\nA Boolean closes the cut for you. If you cut with Bisect and left **Fill** off, or you deleted faces by hand, close it yourself:\n\n1. In Edit Mode choose **Select > Select All by Trait > Non Manifold**. The open edge loop of the cut is selected (32 edges in my test).\n2. Press **F** to fill it. The result is closed, with one large flat face.\n3. For quads on the cut face, choose **Face > Grid Fill** instead. It worked on the same loop and gave a closed result too. **F** leaves one n-gon, which is fine for printing.\n\nFor holes that are not a flat loop, see [how to fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads).\n\n## Step 5: add pin sockets so the parts line up\n\nGlued flat faces slide against each other. Round pins and sockets fix that.\n\n1. Add a cylinder (**Shift A > Mesh > Cylinder**) for the socket: a radius a little bigger than the pin, and a length that reaches into both halves. Centre it on the cut plane.\n2. Apply a Boolean **Difference** with the cylinder as operand to the lower half, and again to the upper half. The same cylinder cuts a socket in both.\n3. Model a pin as a second cylinder, a bit smaller than the socket, as long as the two socket depths together. Print it separately.\n\nIn my test both halves got the socket and stayed closed. A printed pin needs clearance. For example, a 6 mm pin in a 6.4 mm socket leaves 0.2 mm each side (my test used radii of 0.30 and 0.32 units). Printers differ, so print one pair first. Keep sockets away from the outline, where they would leave a paper-thin wall.\n\n## Step 6: separate loose parts\n\nIf a cut leaves several pieces in one object, split them into objects. In my test a Boolean Difference with a thin slab through a sphere left two floating halves in one mesh.\n\n1. In Edit Mode press **A**, then **P** and choose **By Loose Parts**. The path is **Mesh > Separate > By Loose Parts**.\n2. Back in Object Mode each piece is its own object. Both pieces were closed in my test.\n\n## Cuts that are not flat\n\nBisect and a cutter cube make flat cuts. For a curved dividing line, select the faces on one side in Edit Mode and press **P > Selection** (**Mesh > Separate > Selection**). In my test I selected a wavy band of faces on a UV sphere (the dividing line followed z = 0.25 sin 3x) and separated it. That gave two objects of 256 faces each, both open along a 40-edge boundary. Pressing **F** on each boundary loop closed both parts with a single 40-sided face. The two cut faces are not flat, so they will not sit flush against each other, and you have to check the fit and the walls yourself. BedSplit below only cuts flat planes.\n\n## Step 7: check every part\n\nCheck each part before you slice it. The built-in way:\n\n1. In Edit Mode choose **Select > Select All by Trait > Non Manifold**. Nothing should be selected. Anything selected is an open edge or a bad vertex.\n2. Turn on **Overlays > Statistics** to see face and vertex counts, and check the **Dimensions** of each part in the **Item** tab against the bed.\n\nThe 3D-Print Toolbox is the usual extra check. Since Blender 4.2 it is an extension, installed from **Edit > Preferences > Get Extensions**. I did not test it, so this guide uses the built-in selection.\n\n## Step 8: export only the parts\n\n1. Select the parts you want. In Blender 4.2 and later, choose **File > Export > STL (.stl)**.\n2. On the right of the file window switch on **Export Selected Objects**. Leave **Scene Unit** off, as explained in step 1, and decide about **Apply Modifiers**. If you did not apply your Boolean modifiers, switch it on.\n\nIn my test, with **Export Selected Objects** on, only the selected cube was in the file, 12 triangles, and with it off both cubes were, 24 triangles.\n\n## What goes wrong\n\n- **The cut leaves a hole.** Fill was off, or the model was not closed. Use steps 4 and 7.\n- **The two halves overlap or leave a gap.** The Bisect plane and the cutter face are not on the same plane. Type the plane numbers.\n- **The model prints at the wrong size.** The unit setup in step 1 was skipped.\n- **The part is still too big.** Cut again along another axis. Every cut means more fill, sockets and checks.\n- More fixes are on the [BedSplit troubleshooting page](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting).\n\n## Which method fits\n\n| Method | Good for | Breaks when |\n|---|---|---|\n| Bisect with Fill | One flat cut, fast | Many cuts, or sockets by hand |\n| Boolean with a cutter cube | Cut shapes you control, repeatable | Mesh is not closed |\n| Grid Fill or F on the cut | Fixing a cut left open | The cut is not a flat loop |\n| Cylinder Boolean for pins | Alignment between parts | You need dozens of joints |\n| Separate by Loose Parts | Splitting one object into objects | Parts touch each other |\n\n## Faster with BedSplit\n\nWith many cuts, the manual route repeats the chain above for every joint. [BedSplit](\u002Faddons\u002Fbedsplit) does it for you:\n\n- Pick your printer in the **BedSplit** tab of the sidebar (**N**), or choose **Custom** and type the bed size. It has presets for Bambu Lab, Prusa, Creality, Anycubic, Elegoo, Sovol and Voron machines.\n- Turn on **Resize for print** and enter the longest side in millimetres, so you do not set up units.\n- Press **Find Cuts** to see the cut planes in the viewport, move or remove a plane, or add one with the X, Y or Z buttons, then press **Split to Bed**.\n- Each joint gets round dowel sockets in both faces, and you set the diameter, depth, clearance and the dowels per joint. A socket is only placed where the wall is thick enough.\n- Each part is turned flat on its cut face, the **Result** panel lists every part with its size and whether it fits and is closed, and **Export STL** writes one file per part in millimetres, plus the dowel.\n- Holes, flipped normals and overlapping shells are repaired first. The parts are new objects and your original stays.\n\nIts limits: the cuts are flat planes along X, Y and Z (you can move them, not rotate them), the dowels are round, and there is no hollowing or supports. It works in Blender 4.2 and newer. The steps are in the [BedSplit workflows](\u002Fdocs\u002Fbedsplit\u002Fworkflows).\n\nThe free BedSplit Lite splits a watertight model to your bed with flat cuts and exports one STL per part, without dowels, mesh repair or the cut preview.\n\nFor one or two cuts, the manual methods above are enough.\n",{"title":2428,"description":3051},"guides\u002Fsplit-model-for-3d-printing","\u002Fmedia\u002Fbedsplit.mp4","5n2cfxlGyZ8ISzxNukRgaYCCPO-vdFAyafC4C8rOwdE",1794858940833]