[{"data":1,"prerenderedAt":6334},["ShallowReactive",2],{"docs-hub-addons":3,"docs-hub":958},[4,421,725],{"id":5,"title":6,"blender":7,"body":8,"buy":398,"description":402,"extension":403,"lite":404,"meta":406,"name":407,"navigation":408,"path":409,"poster":410,"price":411,"problem":412,"rawbody":413,"seo":414,"status":415,"stem":416,"updated":417,"version":418,"video":419,"__hash__":420},"addons\u002Faddons\u002Fbedsplit.md","BedSplit Blender add-on: split to bed size","4.2 and newer",{"type":9,"value":10,"toc":385},"minimark",[11,16,20,24,32,82,91,98,102,105,181,187,191,197,201,204,281,285,296,300,318,322,329,333,341],[12,13,15],"h2",{"id":14},"the-problem","The problem",[17,18,19],"p",{},"You have a helmet, a statue, a piece of terrain or an AI-generated figure, and it is larger than your printer bed. A 220 mm bed does not care that the model looks great on screen. You need to cut it, keep every part inside the build volume, and make sure the parts line up when you glue them. Doing that by hand means placing planes, running booleans, fixing the holes the booleans leave, modelling pins and sockets, and rotating every piece so it lies flat. For a model that needs six or eight parts, that is an evening.",[12,21,23],{"id":22},"what-bedsplit-does","What BedSplit does",[17,25,26,27,31],{},"BedSplit is a Blender add-on with one sidebar tab. You pick a printer, press ",[28,29,30],"strong",{},"Split to Bed",", and it does the rest:",[33,34,35,42,52,58,64,70,76],"ul",{},[36,37,38,41],"li",{},[28,39,40],{},"Fits the bed."," It counts how many slabs each axis needs for the printer's width, depth and height, and places flat cuts along X, Y and Z. Positions are nudged away from spots where the cross-section is too small to hold a dowel.",[36,43,44,47,48,51],{},[28,45,46],{},"Cut planes you can move."," ",[28,49,50],{},"Find Cuts"," shows the planes in the viewport. You can change any position in millimetres, add a cut on X, Y or Z, or remove one, then split. This is how you keep a cut off a face or a hand.",[36,53,54,57],{},[28,55,56],{},"Dowel sockets."," Every joint gets round sockets in both faces, plus one dowel mesh to print as many times as the name says. You set diameter, depth, clearance and the number of dowels per joint.",[36,59,60,63],{},[28,61,62],{},"Mesh repair first."," Holes, flipped normals, loose geometry, overlapping shells and non-manifold edges are fixed before cutting. The result panel tells you what was repaired and warns when the surface had to be rebuilt.",[36,65,66,69],{},[28,67,68],{},"Parts laid flat."," Each part is turned so its largest cut face sits on the ground, then placed beside your model in its own colour. Your original object is not changed.",[36,71,72,75],{},[28,73,74],{},"Checks you can read."," For every part the panel shows its size in millimetres and a check mark when it fits the bed and is closed.",[36,77,78,81],{},[28,79,80],{},"Per-part STL export."," One STL per part in millimetres, plus one dowel file.",[17,83,84,85,90],{},"Details for every control are in the ",[86,87,89],"a",{"href":88},"\u002Fdocs\u002Fbedsplit\u002Fpanel","panel reference",".",[17,92,93],{},[94,95],"img",{"alt":96,"src":97},"BedSplit in Blender: a knight figure cut by red, green and blue cut planes, with the BedSplit sidebar showing Resize for print, the cut positions, dowel settings and a Result panel that lists the parts","\u002Fmedia\u002Fbedsplit-result-panel.jpg",[12,99,101],{"id":100},"printer-presets","Printer presets",[17,103,104],{},"The preset list holds 18 printers, or you can type any bed size:",[106,107,108,121],"table",{},[109,110,111],"thead",{},[112,113,114,118],"tr",{},[115,116,117],"th",{},"Brand",[115,119,120],{},"Presets",[122,123,124,133,141,149,157,165,173],"tbody",{},[112,125,126,130],{},[127,128,129],"td",{},"Bambu Lab",[127,131,132],{},"A1 mini, A1 \u002F P1 \u002F X1, H2D",[112,134,135,138],{},[127,136,137],{},"Prusa",[127,139,140],{},"MINI+, MK4 \u002F MK3, XL, CORE One",[112,142,143,146],{},[127,144,145],{},"Creality",[127,147,148],{},"Ender 3 \u002F V3 SE, K1, K1 Max, Ender 5 Plus",[112,150,151,154],{},[127,152,153],{},"Anycubic",[127,155,156],{},"Kobra 2, Kobra 3",[112,158,159,162],{},[127,160,161],{},"Elegoo",[127,163,164],{},"Neptune 4, Neptune 4 Max",[112,166,167,170],{},[127,168,169],{},"Sovol",[127,171,172],{},"SV06",[112,174,175,178],{},[127,176,177],{},"Voron",[127,179,180],{},"2.4 300, 0.2",[17,182,183,184,90],{},"The exact sizes are in the ",[86,185,89],{"href":186},"\u002Fdocs\u002Fbedsplit\u002Fpanel#printer-presets",[12,188,190],{"id":189},"resize-for-print","Resize for print",[17,192,193,194,196],{},"If your model is a 2 m sculpt in Blender units, scale does not need to be solved first. Turn on ",[28,195,190],{},", type the real length of the longest side in millimetres, and BedSplit works at that size. Leave it off and the model is read at its current scale, using the scene unit scale.",[12,198,200],{"id":199},"honest-limits","Honest limits",[17,202,203],{},"Each limit links to the troubleshooting entry that explains what to do about it.",[33,205,206,216,222,232,242,255,265,271],{},[36,207,208,211,212,90],{},[28,209,210],{},"Flat axis-aligned cuts only."," Planes run along X, Y and Z. You can slide them, add them and remove them, but you cannot tilt them, and there are no curved or seam-following cuts. If a cut has to avoid a face, move it a few millimetres. See ",[86,213,215],{"href":214},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#n-parts-larger-than-the-bed-add-a-cut-plane","parts still larger than the bed",[36,217,218,221],{},[28,219,220],{},"One joint type."," Joints are round dowels. There are no dovetails, magnet pockets or snap fits.",[36,223,224,227,228,90],{},[28,225,226],{},"Thin sections get no dowel."," A socket needs 1.6 mm of material around it in both parts. With the default 6 mm dowel and 0.2 mm clearance, that means a cross-section of roughly 10 mm. Thinner joints stay flat, and the panel counts them so you can glue them. See ",[86,229,231],{"href":230},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#some-joints-have-no-dowel","joints without a dowel",[36,233,234,237,238,90],{},[28,235,236],{},"Badly broken meshes are rebuilt, not mended."," When a light repair cannot make the mesh a clean solid, BedSplit rebuilds the surface with a voxel remesh. That closes every gap but rounds off fine detail. The panel gives the deviation in millimetres and shows a heavy-repair warning when more than 1 percent of the surface moved by over 0.5 mm. In Pavel's own test meshes, downloaded and AI-generated models among them, most passed every check and a few needed the rebuild and lost visible detail. See ",[86,239,241],{"href":240},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#the-model-has-holes-or-is-not-manifold-do-i-need-to-fix-it-first","holes and non-manifold meshes",[36,243,244,247,248,250,251,90],{},[28,245,246],{},"A 64-part ceiling."," If the bed would need more than 64 parts, BedSplit stops and asks you to check the scale. A figure that really needs 64 pieces is rare, whereas a model in metres read as millimetres is common, so the ceiling catches the mistake before it becomes a minute of cutting. Use ",[28,249,190],{}," to fix it. See ",[86,252,254],{"href":253},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#it-says-the-model-is-mm-long-and-needs-about-parts-turn-on-resize-for-print","the scale message",[36,256,257,260,261,90],{},[28,258,259],{},"Dense meshes take a while."," The cut itself is usually quick. A mesh with millions of faces, or one that needs a rebuild, can take half a minute, and the cursor shows it is working. See ",[86,262,264],{"href":263},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#splitting-is-slow","slow splits",[36,266,267,270],{},[28,268,269],{},"Built for filament printing."," There is no hollowing, no support generation and no 3MF export, so a resin printer gets solid parts and you hollow them in your slicer.",[36,272,273,276,277,90],{},[28,274,275],{},"Fit depends on your printer."," The exported parts were sliced in PrusaSlicer to confirm they are closed, but printers over- or under-extrude differently, so print one small joint before a long job. See ",[86,278,280],{"href":279},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#the-dowels-are-too-tight-or-too-loose","dowels too tight or too loose",[12,282,284],{"id":283},"requirements","Requirements",[17,286,287,288,291,292,90],{},"Blender 4.2 or newer, installed as an extension. It was tested on 4.2, 4.5 and 5.2. It writes STL files only when you press ",[28,289,290],{},"Export STL",". See ",[86,293,295],{"href":294},"\u002Fdocs\u002Fbedsplit\u002Finstall","installation",[12,297,299],{"id":298},"free-lite-version","Free Lite version",[17,301,302,303,305,306,308,309,311,312,90],{},"BedSplit Lite is a separate, free, open-source extension. It has the printer presets, ",[28,304,190],{},", ",[28,307,30],{}," with flat cuts and capped, closed parts, parts laid flat and per-part STL export. It does not have dowels and sockets, mesh repair, ",[28,310,50],{},", movable planes or the dowel settings. If your model is already watertight and you glue the parts, Lite may be all you need. Download it from the ",[86,313,317],{"href":314,"rel":315},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fbedsplit-lite\u002Freleases\u002Flatest",[316],"nofollow","BedSplit Lite releases page",[12,319,321],{"id":320},"how-to-buy","How to buy",[17,323,324,325,90],{},"BedSplit costs $22 and is sold on Gumroad. Updates are free. You get a zip file that you install from disk in Blender, without unzipping it. Questions can go through the ",[86,326,328],{"href":327},"\u002Fcontact","contact page",[12,330,332],{"id":331},"learn-more","Learn more",[17,334,335,336,340],{},"Built and tested by Pavel at Mendbox Studio (",[86,337,339],{"href":338},"\u002Fabout","about",").",[33,342,343,349,354,359,365,371,377],{},[36,344,345],{},[86,346,348],{"href":347},"\u002Fdocs\u002Fbedsplit","Overview of the documentation",[36,350,351],{},[86,352,353],{"href":294},"Install BedSplit",[36,355,356],{},[86,357,358],{"href":88},"Panel reference",[36,360,361],{},[86,362,364],{"href":363},"\u002Fdocs\u002Fbedsplit\u002Fworkflows","Step-by-step workflows",[36,366,367],{},[86,368,370],{"href":369},"\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting","Troubleshooting",[36,372,373],{},[86,374,376],{"href":375},"\u002Fdocs\u002Fbedsplit#version-history","Version history",[36,378,379,380,384],{},"Guide: ",[86,381,383],{"href":382},"\u002Fguides\u002Fsplit-model-for-3d-printing","how to split a model for 3D printing",", including the manual method in plain Blender",{"title":386,"searchDepth":387,"depth":387,"links":388},"",2,[389,390,391,392,393,394,395,396,397],{"id":14,"depth":387,"text":15},{"id":22,"depth":387,"text":23},{"id":100,"depth":387,"text":101},{"id":189,"depth":387,"text":190},{"id":199,"depth":387,"text":200},{"id":283,"depth":387,"text":284},{"id":298,"depth":387,"text":299},{"id":320,"depth":387,"text":321},{"id":331,"depth":387,"text":332},[399],{"label":400,"to":401},"Get BedSplit on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fbedsplit","BedSplit cuts a large Blender model into parts that fit your printer bed, adds dowel sockets, repairs the mesh and exports one STL per part. $22, Blender 4.2+.","md",{"summary":405,"to":314},"BedSplit Lite is free and open source. It splits a watertight model to your bed with flat cuts and exports one STL per part. No dowels, no mesh repair, no cut preview.",{},"BedSplit",true,"\u002Faddons\u002Fbedsplit","\u002Fmedia\u002Fbedsplit.jpg","$22","How do I split a big model to fit my print bed?","---\ntitle: \"BedSplit Blender add-on: split to bed size\"\ndescription: \"BedSplit cuts a large Blender model into parts that fit your printer bed, adds dowel sockets, repairs the mesh and exports one STL per part. $22, Blender 4.2+.\"\nname: BedSplit\nprice: \"$22\"\nstatus: released\nproblem: \"How do I split a big model to fit my print bed?\"\nversion: \"0.1.3\"\nblender: \"4.2 and newer\"\nvideo: \u002Fmedia\u002Fbedsplit.mp4\nposter: \u002Fmedia\u002Fbedsplit.jpg\nbuy:\n  - { label: 'Get BedSplit on Gumroad', to: 'https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fbedsplit' }\nlite:\n  summary: \"BedSplit Lite is free and open source. It splits a watertight model to your bed with flat cuts and exports one STL per part. No dowels, no mesh repair, no cut preview.\"\n  to: \"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fbedsplit-lite\u002Freleases\u002Flatest\"\nupdated: 2026-11-16\n---\n\n## The problem\n\nYou have a helmet, a statue, a piece of terrain or an AI-generated figure, and it is larger than your printer bed. A 220 mm bed does not care that the model looks great on screen. You need to cut it, keep every part inside the build volume, and make sure the parts line up when you glue them. Doing that by hand means placing planes, running booleans, fixing the holes the booleans leave, modelling pins and sockets, and rotating every piece so it lies flat. For a model that needs six or eight parts, that is an evening.\n\n## What BedSplit does\n\nBedSplit is a Blender add-on with one sidebar tab. You pick a printer, press **Split to Bed**, and it does the rest:\n\n- **Fits the bed.** It counts how many slabs each axis needs for the printer's width, depth and height, and places flat cuts along X, Y and Z. Positions are nudged away from spots where the cross-section is too small to hold a dowel.\n- **Cut planes you can move.** **Find Cuts** shows the planes in the viewport. You can change any position in millimetres, add a cut on X, Y or Z, or remove one, then split. This is how you keep a cut off a face or a hand.\n- **Dowel sockets.** Every joint gets round sockets in both faces, plus one dowel mesh to print as many times as the name says. You set diameter, depth, clearance and the number of dowels per joint.\n- **Mesh repair first.** Holes, flipped normals, loose geometry, overlapping shells and non-manifold edges are fixed before cutting. The result panel tells you what was repaired and warns when the surface had to be rebuilt.\n- **Parts laid flat.** Each part is turned so its largest cut face sits on the ground, then placed beside your model in its own colour. Your original object is not changed.\n- **Checks you can read.** For every part the panel shows its size in millimetres and a check mark when it fits the bed and is closed.\n- **Per-part STL export.** One STL per part in millimetres, plus one dowel file.\n\nDetails for every control are in the [panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel).\n\n![BedSplit in Blender: a knight figure cut by red, green and blue cut planes, with the BedSplit sidebar showing Resize for print, the cut positions, dowel settings and a Result panel that lists the parts](\u002Fmedia\u002Fbedsplit-result-panel.jpg)\n\n## Printer presets\n\nThe preset list holds 18 printers, or you can type any bed size:\n\n| Brand | Presets |\n|---|---|\n| Bambu Lab | A1 mini, A1 \u002F P1 \u002F X1, H2D |\n| Prusa | MINI+, MK4 \u002F MK3, XL, CORE One |\n| Creality | Ender 3 \u002F V3 SE, K1, K1 Max, Ender 5 Plus |\n| Anycubic | Kobra 2, Kobra 3 |\n| Elegoo | Neptune 4, Neptune 4 Max |\n| Sovol | SV06 |\n| Voron | 2.4 300, 0.2 |\n\nThe exact sizes are in the [panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel#printer-presets).\n\n## Resize for print\n\nIf your model is a 2 m sculpt in Blender units, scale does not need to be solved first. Turn on **Resize for print**, type the real length of the longest side in millimetres, and BedSplit works at that size. Leave it off and the model is read at its current scale, using the scene unit scale.\n\n## Honest limits\n\nEach limit links to the troubleshooting entry that explains what to do about it.\n\n- **Flat axis-aligned cuts only.** Planes run along X, Y and Z. You can slide them, add them and remove them, but you cannot tilt them, and there are no curved or seam-following cuts. If a cut has to avoid a face, move it a few millimetres. See [parts still larger than the bed](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#n-parts-larger-than-the-bed-add-a-cut-plane).\n- **One joint type.** Joints are round dowels. There are no dovetails, magnet pockets or snap fits.\n- **Thin sections get no dowel.** A socket needs 1.6 mm of material around it in both parts. With the default 6 mm dowel and 0.2 mm clearance, that means a cross-section of roughly 10 mm. Thinner joints stay flat, and the panel counts them so you can glue them. See [joints without a dowel](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#some-joints-have-no-dowel).\n- **Badly broken meshes are rebuilt, not mended.** When a light repair cannot make the mesh a clean solid, BedSplit rebuilds the surface with a voxel remesh. That closes every gap but rounds off fine detail. The panel gives the deviation in millimetres and shows a heavy-repair warning when more than 1 percent of the surface moved by over 0.5 mm. In Pavel's own test meshes, downloaded and AI-generated models among them, most passed every check and a few needed the rebuild and lost visible detail. See [holes and non-manifold meshes](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#the-model-has-holes-or-is-not-manifold-do-i-need-to-fix-it-first).\n- **A 64-part ceiling.** If the bed would need more than 64 parts, BedSplit stops and asks you to check the scale. A figure that really needs 64 pieces is rare, whereas a model in metres read as millimetres is common, so the ceiling catches the mistake before it becomes a minute of cutting. Use **Resize for print** to fix it. See [the scale message](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#it-says-the-model-is-mm-long-and-needs-about-parts-turn-on-resize-for-print).\n- **Dense meshes take a while.** The cut itself is usually quick. A mesh with millions of faces, or one that needs a rebuild, can take half a minute, and the cursor shows it is working. See [slow splits](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#splitting-is-slow).\n- **Built for filament printing.** There is no hollowing, no support generation and no 3MF export, so a resin printer gets solid parts and you hollow them in your slicer.\n- **Fit depends on your printer.** The exported parts were sliced in PrusaSlicer to confirm they are closed, but printers over- or under-extrude differently, so print one small joint before a long job. See [dowels too tight or too loose](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting#the-dowels-are-too-tight-or-too-loose).\n\n## Requirements\n\nBlender 4.2 or newer, installed as an extension. It was tested on 4.2, 4.5 and 5.2. It writes STL files only when you press **Export STL**. See [installation](\u002Fdocs\u002Fbedsplit\u002Finstall).\n\n## Free Lite version\n\nBedSplit Lite is a separate, free, open-source extension. It has the printer presets, **Resize for print**, **Split to Bed** with flat cuts and capped, closed parts, parts laid flat and per-part STL export. It does not have dowels and sockets, mesh repair, **Find Cuts**, movable planes or the dowel settings. If your model is already watertight and you glue the parts, Lite may be all you need. Download it from the [BedSplit Lite releases page](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fbedsplit-lite\u002Freleases\u002Flatest).\n\n## How to buy\n\nBedSplit costs $22 and is sold on Gumroad. Updates are free. You get a zip file that you install from disk in Blender, without unzipping it. Questions can go through the [contact page](\u002Fcontact).\n\n## Learn more\n\nBuilt and tested by Pavel at Mendbox Studio ([about](\u002Fabout)).\n\n- [Overview of the documentation](\u002Fdocs\u002Fbedsplit)\n- [Install BedSplit](\u002Fdocs\u002Fbedsplit\u002Finstall)\n- [Panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel)\n- [Step-by-step workflows](\u002Fdocs\u002Fbedsplit\u002Fworkflows)\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting)\n- [Version history](\u002Fdocs\u002Fbedsplit#version-history)\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing), including the manual method in plain Blender\n",{"title":6,"description":402},"released","addons\u002Fbedsplit","2026-11-16","0.1.3","\u002Fmedia\u002Fbedsplit.mp4","AWWRux7H46pGSTcya4nV1F3rkKd9_3UJim5HXXRVuuk",{"id":422,"title":423,"blender":7,"body":424,"buy":704,"description":711,"extension":403,"lite":712,"meta":714,"name":715,"navigation":408,"path":716,"poster":717,"price":667,"problem":718,"rawbody":719,"seo":720,"status":415,"stem":721,"updated":417,"version":722,"video":723,"__hash__":724},"addons\u002Faddons\u002Fimage-per-instance.md","Image Per Instance add-on for Blender",{"type":9,"value":425,"toc":694},[426,428,431,438,444,448,490,493,497,546,552,556,569,571,623,630,634,636,639,641,660,662],[12,427,15],{"id":14},[17,429,430],{},"You have forty picture frames, a shelf of book covers or a wall of cards, and each one needs its own image. In Blender a material points at a single image, and the Image Texture node offers no input that says which picture an individual instance should show. The usual ways out are one material per object, which gets heavy fast, or a hand-built texture atlas with a custom attribute and a pile of math nodes that you have to rebuild every time something changes.",[17,432,433,434,437],{},"Image Per Instance builds that setup for you. You point it at a folder, press ",[28,435,436],{},"Build Atlas",", and every object, array element or Geometry Nodes instance can show a different image while sharing one material.",[17,439,440],{},[94,441],{"alt":442,"src":443},"Before and after in Blender: the same image on every frame, then a different image on each of the 40 frames","\u002Fmedia\u002Fipi-before-after.jpg",[12,445,447],{"id":446},"what-it-does","What it does",[33,449,450,464,470,480],{},[36,451,452,454,455,459,460,463],{},[28,453,436],{}," reads every image in a folder, resizes each one into a tile, and packs them into a single atlas image stored inside your .blend file. The atlas is always in natural file-name order (",[456,457,458],"code",{},"img2"," before ",[456,461,462],{},"img10","), so Image Number 3 is always the third file.",[36,465,466,469],{},[28,467,468],{},"Apply To Selected Objects"," gives each selected mesh its own tile. The image index is stored as a custom property on the object.",[36,471,472,475,476,479],{},[28,473,474],{},"Add To Instances (Geometry Nodes)"," is for Instance on Points, the Array modifier and collection instances. It looks through the host's Geometry Nodes for the objects being instanced (Object Info and Collection Info nodes, including nested groups), puts the shared material on them, and adds a modifier called ",[28,477,478],{},"IPI Assign Index"," to the host. That modifier writes an image number onto every instance, and the material reads it.",[36,481,482,485,486,489],{},[28,483,484],{},"Order"," can be \"By file name\" or \"Shuffle\". Shuffle uses every image once before any repeats, and a ",[28,487,488],{},"Seed"," field gives you other arrangements.",[17,491,492],{},"One material, one atlas, and the material is made of ordinary Blender nodes.",[12,494,496],{"id":495},"beyond-the-basics-full-version","Beyond the basics (full version)",[33,498,499,505,522,528,534,540],{},[36,500,501,504],{},[28,502,503],{},"Tile shape and fit:"," pick a tile shape (1:1, 2:3, 3:2, 3:4, 4:3, 16:9, 9:16) and a fit mode (Stretch, Fit with bars in a colour you choose, or Fill with crop) so pictures are not squashed.",[36,506,507,510,511,514,515,518,519,90],{},[28,508,509],{},"Choose images yourself:"," pick an image by number or by name, or use ",[28,512,513],{},"Match By Object Name"," so an object called ",[456,516,517],{},"poster_cat"," shows ",[456,520,521],{},"cat.png",[36,523,524,527],{},[28,525,526],{},"Material options:"," use image alpha, make the image glow like a screen, set roughness.",[36,529,530,533],{},[28,531,532],{},"Mapping without UVs:"," project from the front, top or side across the whole object.",[36,535,536,539],{},[28,537,538],{},"Animate:"," every object steps through the images every N frames, each starting at its own image.",[36,541,542,545],{},[28,543,544],{},"Random variation:"," shift hue, saturation and brightness per object, and mirror a random half of the objects.",[17,547,548,549,90],{},"Every control is listed in the ",[86,550,89],{"href":551},"\u002Fdocs\u002Fimage-per-instance\u002Fpanel",[12,553,555],{"id":554},"what-you-can-use-it-for","What you can use it for",[17,557,558,559,563,564,568],{},"Book spines and covers, posters, paintings and photo frames, cards and tiles, packaging and props, video-wall panels and billboards, and anything scattered or arrayed with Geometry Nodes. Step-by-step recipes are in the ",[86,560,562],{"href":561},"\u002Fdocs\u002Fimage-per-instance\u002Fworkflows","workflows page",", and the guide ",[86,565,567],{"href":566},"\u002Fguides\u002Fdifferent-image-per-instance","different image per instance in Blender"," shows the manual method first.",[12,570,200],{"id":199},[33,572,573,583,590,597,604,607,620],{},[36,574,575,576,578,579,90],{},"One atlas per .blend file. Pressing ",[28,577,436],{}," again replaces it, and objects keep their pictures by file name. See ",[86,580,582],{"href":581},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-did-my-images-change-after-pressing-build-atlas-again","rebuilding the atlas",[36,584,585,586,90],{},"The atlas can be at most 16384 px on each side. For example 256 images at 1024 px fit exactly, 257 do not. See ",[86,587,589],{"href":588},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#what-if-the-atlas-is-too-big-limit-16384","the atlas size limit",[36,591,592,593,90],{},"Front, Top and Side mapping projects straight through the object's bounding box from one direction. Faces that turn away from that direction smear the image into streaks, so give such objects a UV map. See ",[86,594,596],{"href":595},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-do-some-faces-look-streaked-with-front-top-or-side-mapping","streaked faces",[36,598,599,600,90],{},"With few images the Shuffle order can show a visible rhythm. See ",[86,601,603],{"href":602},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-shuffle-look-repetitive","repetitive shuffle",[36,605,606],{},"The image goes on material slot 1 of each object. Other slots stay untouched.",[36,608,609,612,613,615,616,90],{},[28,610,611],{},"Assign Image To Selected"," and ",[28,614,513],{}," work on separate objects, not on Geometry Nodes instances. See ",[86,617,619],{"href":618},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-the-instances-button-say-no-instanced-source-found","no instanced source found",[36,621,622],{},"It is not a replacement for UDIM or texture painting.",[17,624,625,626,90],{},"More cases are covered in ",[86,627,629],{"href":628},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting","troubleshooting",[17,631,335,632,340],{},[86,633,339],{"href":338},[12,635,284],{"id":283},[17,637,638],{},"Blender 4.2 or newer. The add-on's test scripts run on Blender 4.2.23 LTS, 4.5.14 LTS and 5.2.2 LTS. The add-on is pure Python, needs no internet and no extra software, and is licensed GPL-3.0-or-later.",[12,640,299],{"id":298},[17,642,643,644,612,646,648,649,654,655,659],{},"Image Per Instance Lite is a separate free download. It has ",[28,645,436],{},[28,647,468],{}," for separate objects, with up to 20 images. Instances, Shuffle, fit modes, assign by name, alpha and emission, mapping without UVs, animation and variation are in the full version only. ",[86,650,653],{"href":651,"rel":652},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite",[316],"Get Lite on GitHub",", and see the ",[86,656,658],{"href":657},"\u002Fdocs\u002Fimage-per-instance\u002Finstall","install page"," for the differences.",[12,661,321],{"id":320},[17,663,664,665,668,669,674,675,680,681,684,685,689,690,90],{},"The full version is ",[28,666,667],{},"$12",". Buy it on ",[86,670,673],{"href":671,"rel":672},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[316],"Gumroad"," or ",[86,676,679],{"href":677,"rel":678},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[316],"Superhive",", then install the zip in Blender as described in the ",[86,682,683],{"href":657},"install guide",". The ",[86,686,688],{"href":687},"\u002Fdocs\u002Fimage-per-instance","full documentation"," lists every page, including the ",[86,691,693],{"href":692},"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog","changelog",{"title":386,"searchDepth":387,"depth":387,"links":695},[696,697,698,699,700,701,702,703],{"id":14,"depth":387,"text":15},{"id":446,"depth":387,"text":447},{"id":495,"depth":387,"text":496},{"id":554,"depth":387,"text":555},{"id":199,"depth":387,"text":200},{"id":283,"depth":387,"text":284},{"id":298,"depth":387,"text":299},{"id":320,"depth":387,"text":321},[705,708],{"label":706,"to":707},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance",{"label":709,"to":710},"Buy on Superhive","https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance","Blender add-on that packs a folder of images into one atlas and gives every object, array element or Geometry Nodes instance its own picture on one material.",{"summary":713,"to":651},"Free and open source (GPL). Builds the atlas and puts a different image on separate objects, up to 20 images. No Geometry Nodes instances.",{},"Image Per Instance","\u002Faddons\u002Fimage-per-instance","\u002Fmedia\u002Fipi.jpg","How do I put a different image on every object in Blender?","---\ntitle: \"Image Per Instance add-on for Blender\"\ndescription: \"Blender add-on that packs a folder of images into one atlas and gives every object, array element or Geometry Nodes instance its own picture on one material.\"\nname: \"Image Per Instance\"\nprice: \"$12\"\nstatus: released\nproblem: \"How do I put a different image on every object in Blender?\"\nversion: \"0.2.0\"\nblender: \"4.2 and newer\"\nvideo: \u002Fmedia\u002Fipi.mp4\nposter: \u002Fmedia\u002Fipi.jpg\nbuy:\n  - label: \"Buy on Gumroad\"\n    to: \"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance\"\n  - label: \"Buy on Superhive\"\n    to: \"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance\"\nlite:\n  summary: \"Free and open source (GPL). Builds the atlas and puts a different image on separate objects, up to 20 images. No Geometry Nodes instances.\"\n  to: \"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite\"\nupdated: 2026-11-16\n---\n\n## The problem\n\nYou have forty picture frames, a shelf of book covers or a wall of cards, and each one needs its own image. In Blender a material points at a single image, and the Image Texture node offers no input that says which picture an individual instance should show. The usual ways out are one material per object, which gets heavy fast, or a hand-built texture atlas with a custom attribute and a pile of math nodes that you have to rebuild every time something changes.\n\nImage Per Instance builds that setup for you. You point it at a folder, press **Build Atlas**, and every object, array element or Geometry Nodes instance can show a different image while sharing one material.\n\n![Before and after in Blender: the same image on every frame, then a different image on each of the 40 frames](\u002Fmedia\u002Fipi-before-after.jpg)\n\n## What it does\n\n- **Build Atlas** reads every image in a folder, resizes each one into a tile, and packs them into a single atlas image stored inside your .blend file. The atlas is always in natural file-name order (`img2` before `img10`), so Image Number 3 is always the third file.\n- **Apply To Selected Objects** gives each selected mesh its own tile. The image index is stored as a custom property on the object.\n- **Add To Instances (Geometry Nodes)** is for Instance on Points, the Array modifier and collection instances. It looks through the host's Geometry Nodes for the objects being instanced (Object Info and Collection Info nodes, including nested groups), puts the shared material on them, and adds a modifier called **IPI Assign Index** to the host. That modifier writes an image number onto every instance, and the material reads it.\n- **Order** can be \"By file name\" or \"Shuffle\". Shuffle uses every image once before any repeats, and a **Seed** field gives you other arrangements.\n\nOne material, one atlas, and the material is made of ordinary Blender nodes.\n\n## Beyond the basics (full version)\n\n- **Tile shape and fit:** pick a tile shape (1:1, 2:3, 3:2, 3:4, 4:3, 16:9, 9:16) and a fit mode (Stretch, Fit with bars in a colour you choose, or Fill with crop) so pictures are not squashed.\n- **Choose images yourself:** pick an image by number or by name, or use **Match By Object Name** so an object called `poster_cat` shows `cat.png`.\n- **Material options:** use image alpha, make the image glow like a screen, set roughness.\n- **Mapping without UVs:** project from the front, top or side across the whole object.\n- **Animate:** every object steps through the images every N frames, each starting at its own image.\n- **Random variation:** shift hue, saturation and brightness per object, and mirror a random half of the objects.\n\nEvery control is listed in the [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel).\n\n## What you can use it for\n\nBook spines and covers, posters, paintings and photo frames, cards and tiles, packaging and props, video-wall panels and billboards, and anything scattered or arrayed with Geometry Nodes. Step-by-step recipes are in the [workflows page](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows), and the guide [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance) shows the manual method first.\n\n## Honest limits\n\n- One atlas per .blend file. Pressing **Build Atlas** again replaces it, and objects keep their pictures by file name. See [rebuilding the atlas](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-did-my-images-change-after-pressing-build-atlas-again).\n- The atlas can be at most 16384 px on each side. For example 256 images at 1024 px fit exactly, 257 do not. See [the atlas size limit](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#what-if-the-atlas-is-too-big-limit-16384).\n- Front, Top and Side mapping projects straight through the object's bounding box from one direction. Faces that turn away from that direction smear the image into streaks, so give such objects a UV map. See [streaked faces](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-do-some-faces-look-streaked-with-front-top-or-side-mapping).\n- With few images the Shuffle order can show a visible rhythm. See [repetitive shuffle](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-shuffle-look-repetitive).\n- The image goes on material slot 1 of each object. Other slots stay untouched.\n- **Assign Image To Selected** and **Match By Object Name** work on separate objects, not on Geometry Nodes instances. See [no instanced source found](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-the-instances-button-say-no-instanced-source-found).\n- It is not a replacement for UDIM or texture painting.\n\nMore cases are covered in [troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\nBuilt and tested by Pavel at Mendbox Studio ([about](\u002Fabout)).\n\n## Requirements\n\nBlender 4.2 or newer. The add-on's test scripts run on Blender 4.2.23 LTS, 4.5.14 LTS and 5.2.2 LTS. The add-on is pure Python, needs no internet and no extra software, and is licensed GPL-3.0-or-later.\n\n## Free Lite version\n\nImage Per Instance Lite is a separate free download. It has **Build Atlas** and **Apply To Selected Objects** for separate objects, with up to 20 images. Instances, Shuffle, fit modes, assign by name, alpha and emission, mapping without UVs, animation and variation are in the full version only. [Get Lite on GitHub](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite), and see the [install page](\u002Fdocs\u002Fimage-per-instance\u002Finstall) for the differences.\n\n## How to buy\n\nThe full version is **$12**. Buy it on [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance) or [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance), then install the zip in Blender as described in the [install guide](\u002Fdocs\u002Fimage-per-instance\u002Finstall). The [full documentation](\u002Fdocs\u002Fimage-per-instance) lists every page, including the [changelog](\u002Fdocs\u002Fimage-per-instance\u002Fchangelog).\n",{"title":423,"description":711},"addons\u002Fimage-per-instance","0.2.0","\u002Fmedia\u002Fipi.mp4","54Wmn5jGdlRjQ-6eDveUyo_uk8jHjm5YvLuKUbAr1rk",{"id":726,"title":727,"blender":7,"body":728,"buy":940,"description":945,"extension":403,"lite":946,"meta":948,"name":747,"navigation":408,"path":949,"poster":950,"price":667,"problem":951,"rawbody":952,"seo":953,"status":415,"stem":954,"updated":417,"version":955,"video":956,"__hash__":957},"addons\u002Faddons\u002Fquadfix.md","QuadFix: Blender quad fill & cleanup add-on",{"type":9,"value":729,"toc":931},[730,732,735,738,742,749,787,797,803,809,813,816,830,838,840,848,852,875,879,894,896,916],[12,731,15],{"id":14},[17,733,734],{},"You cut a hole with a Boolean and the cut edge is a ragged line of triangles and n-gons. You import an STL, an OBJ or a CAD export and half the surface is triangles. You delete a few faces on a scan and now there is a gap that Grid Fill refuses to close, because the loop has an odd number of edges. Blender has tools for each of these, but each one stops at a limit you only find by trying.",[17,736,737],{},"QuadFix is one panel that covers these cases. You select the mess, press a button, and read a short report of what changed. Every step is a normal Blender undo step.",[12,739,741],{"id":740},"what-quadfix-does","What QuadFix does",[17,743,744,745,748],{},"The tools live in the ",[28,746,747],{},"QuadFix"," tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.",[33,750,751,757,763,769,775,781],{},[36,752,753,756],{},[28,754,755],{},"Fill Holes with Quads"," closes open holes and closed boundary loops with a quad grid that continues the mesh around it, instead of a triangle fan or one big flat face. Odd edge counts, irregular outlines and band-shaped gaps between two loops are handled. Use it for deleted faces, scan holes and ripped game models.",[36,758,759,762],{},[28,760,761],{},"Bridge to Quads"," joins two selected edge loops, or two open edge chains, with a strip of quads, even when they have different numbers of edges (up to 4 to 1). Use it where Blender's Bridge Edge Loops leaves triangles or a twisted strip.",[36,764,765,768],{},[28,766,767],{},"N-gons to Quads"," triangulates curved n-gons and joins triangles into quads with adjustable angles. Flat n-gons stay as they are by default, so clean CAD faces are not touched.",[36,770,771,774],{},[28,772,773],{},"Clean & Quad (Boolean Prep)"," merges doubles, removes degenerate and loose geometry, dissolves leftover junk with a limited dissolve, joins triangles into quads and recalculates normals. Use it right after a Boolean or an import.",[36,776,777,780],{},[28,778,779],{},"Select Non-Quads & Holes"," selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.",[36,782,783,786],{},[28,784,785],{},"Union to Quads"," runs an exact Boolean union of two or more mesh objects and rebuilds the seam as a strip of quads. The originals are hidden, not deleted. This one works in Object Mode.",[17,788,789,790,793,794,90],{},"Every option is described in the ",[86,791,89],{"href":792},"\u002Fdocs\u002Fquadfix\u002Fpanel",". Step-by-step recipes are in the ",[86,795,562],{"href":796},"\u002Fdocs\u002Fquadfix\u002Fworkflows",[17,798,799],{},[94,800],{"alt":801,"src":802},"A triangulated scan-like sphere in Blender, before N-gons to Quads, covered in a regular pattern of triangles","\u002Fmedia\u002Fquadfix-scan-to-quads-before.jpg",[17,804,805],{},[94,806],{"alt":807,"src":808},"The same sphere after N-gons to Quads: most triangles are joined into quads, a few triangles remain in red","\u002Fmedia\u002Fquadfix-scan-to-quads-after.jpg",[12,810,812],{"id":811},"what-it-does-not-do","What it does not do",[17,814,815],{},"QuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.",[33,817,818,821,824,827],{},[36,819,820],{},"Very irregular scans keep some triangles. The result line in the panel tells you how many remain.",[36,822,823],{},"Fill Holes skips the outer border of a flat open sheet, such as a plane or a terrain, and skips holes that are only partly selected.",[36,825,826],{},"Bridge to Quads refuses edge counts further apart than 4 to 1, loops that touch themselves, and selections with more than two loops or chains. Instead of guessing, it stops, selects the problem edges and leaves the mesh unchanged.",[36,828,829],{},"Union to Quads needs closed meshes that overlap. It does not generate UVs for the new strip. A seam that runs through a hole in your input stays a plain Boolean, and the report says how many seams were left that way. Strips on dense meshes with very different densities on the two sides are all quads but can zig-zag.",[17,831,832,833,837],{},"The ",[86,834,836],{"href":835},"\u002Fdocs\u002Fquadfix\u002Ftroubleshooting","troubleshooting page"," lists the messages you can see and what to do about each.",[12,839,284],{"id":283},[17,841,842,843,847],{},"Blender 4.2 or newer. Tested on Blender 4.2, 4.5 and 5.2. The add-on is a Blender extension, installed from a .zip file, and it needs no internet connection and no extra libraries. See ",[86,844,846],{"href":845},"\u002Fdocs\u002Fquadfix\u002Finstall","how to install QuadFix",". The licence is GPL-3.0-or-later.",[12,849,851],{"id":850},"guides","Guides",[33,853,854,861,868],{},[36,855,856,860],{},[86,857,859],{"href":858},"\u002Fguides\u002Ffill-hole-with-quads","Fill a hole with quads",": the manual way first, then the one-click way.",[36,862,863,867],{},[86,864,866],{"href":865},"\u002Fguides\u002Fngons-to-quads","Convert n-gons to quads"," and decide which n-gons to leave alone.",[36,869,870,874],{},[86,871,873],{"href":872},"\u002Fguides\u002Fclean-up-imported-stl","Clean up an imported STL"," before you sculpt, UV or print it.",[12,876,878],{"id":877},"free-quadfix-lite","Free QuadFix Lite",[17,880,881,882,887,888,891,892,90],{},"QuadFix Lite is a free, open-source cut of the add-on, available on ",[86,883,886],{"href":884,"rel":885},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite",[316],"GitHub",". It has three tools: N-gons to Quads, Clean & Quad and Select Non-Quads & Holes, with the same options as the full version. It does not have Fill Holes with Quads, Bridge to Quads or Union to Quads, and it has no Match Triangle Meshes option. Its sidebar tab is called ",[28,889,890],{},"QuadFix Lite",", so it can sit next to the full version. A side-by-side table is on the ",[86,893,658],{"href":845},[12,895,321],{"id":320},[17,897,898,899,903,904,908,909,913,914,340],{},"QuadFix costs $12. You can get it on ",[86,900,673],{"href":901,"rel":902},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[316]," or on ",[86,905,679],{"href":906,"rel":907},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix",[316],". Both give you the same .zip. Free updates are included for the 1.x line. Questions go to ",[86,910,912],{"href":911},"mailto:support@mendboxstudio.com","support@mendboxstudio.com",". Built and tested by Pavel at Mendbox Studio (",[86,915,339],{"href":338},[17,917,918,919,922,923,684,927,930],{},"After purchase, follow the ",[86,920,921],{"href":845},"install steps",", then open the ",[86,924,926],{"href":925},"\u002Fdocs\u002Fquadfix","documentation overview",[86,928,693],{"href":929},"\u002Fdocs\u002Fquadfix\u002Fchangelog"," lists every version.",{"title":386,"searchDepth":387,"depth":387,"links":932},[933,934,935,936,937,938,939],{"id":14,"depth":387,"text":15},{"id":740,"depth":387,"text":741},{"id":811,"depth":387,"text":812},{"id":283,"depth":387,"text":284},{"id":850,"depth":387,"text":851},{"id":877,"depth":387,"text":878},{"id":320,"depth":387,"text":321},[941,943],{"label":706,"to":942},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix",{"label":709,"to":944},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix","QuadFix is a Blender add-on that fills holes with quad grids, bridges edge loops, converts n-gons and triangles to quads and cleans Boolean and imported meshes.",{"summary":947,"to":884},"QuadFix Lite is free and open source. It has N-gons to Quads, Clean & Quad and Select Non-Quads & Holes. Hole filling, bridging and union are in the full version.",{},"\u002Faddons\u002Fquadfix","\u002Fmedia\u002Fquadfix.jpg","Quad hole filling and mesh cleanup in one Blender panel","---\ntitle: \"QuadFix: Blender quad fill & cleanup add-on\"\ndescription: \"QuadFix is a Blender add-on that fills holes with quad grids, bridges edge loops, converts n-gons and triangles to quads and cleans Boolean and imported meshes.\"\nname: QuadFix\nprice: \"$12\"\nstatus: released\nproblem: \"Quad hole filling and mesh cleanup in one Blender panel\"\nversion: \"1.4.5\"\nblender: \"4.2 and newer\"\nvideo: \u002Fmedia\u002Fquadfix.mp4\nposter: \u002Fmedia\u002Fquadfix.jpg\nbuy:\n  - label: Buy on Gumroad\n    to: https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix\n  - label: Buy on Superhive\n    to: https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix\nlite:\n  summary: \"QuadFix Lite is free and open source. It has N-gons to Quads, Clean & Quad and Select Non-Quads & Holes. Hole filling, bridging and union are in the full version.\"\n  to: https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite\nupdated: 2026-11-16\n---\n\n## The problem\n\nYou cut a hole with a Boolean and the cut edge is a ragged line of triangles and n-gons. You import an STL, an OBJ or a CAD export and half the surface is triangles. You delete a few faces on a scan and now there is a gap that Grid Fill refuses to close, because the loop has an odd number of edges. Blender has tools for each of these, but each one stops at a limit you only find by trying.\n\nQuadFix is one panel that covers these cases. You select the mess, press a button, and read a short report of what changed. Every step is a normal Blender undo step.\n\n## What QuadFix does\n\nThe tools live in the **QuadFix** tab of the 3D viewport sidebar. All of them except Union work in Edit Mode.\n\n- **Fill Holes with Quads** closes open holes and closed boundary loops with a quad grid that continues the mesh around it, instead of a triangle fan or one big flat face. Odd edge counts, irregular outlines and band-shaped gaps between two loops are handled. Use it for deleted faces, scan holes and ripped game models.\n- **Bridge to Quads** joins two selected edge loops, or two open edge chains, with a strip of quads, even when they have different numbers of edges (up to 4 to 1). Use it where Blender's Bridge Edge Loops leaves triangles or a twisted strip.\n- **N-gons to Quads** triangulates curved n-gons and joins triangles into quads with adjustable angles. Flat n-gons stay as they are by default, so clean CAD faces are not touched.\n- **Clean & Quad (Boolean Prep)** merges doubles, removes degenerate and loose geometry, dissolves leftover junk with a limited dissolve, joins triangles into quads and recalculates normals. Use it right after a Boolean or an import.\n- **Select Non-Quads & Holes** selects every triangle, n-gon and open boundary edge and prints the counts, so you see what is left to fix.\n- **Union to Quads** runs an exact Boolean union of two or more mesh objects and rebuilds the seam as a strip of quads. The originals are hidden, not deleted. This one works in Object Mode.\n\nEvery option is described in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel). Step-by-step recipes are in the [workflows page](\u002Fdocs\u002Fquadfix\u002Fworkflows).\n\n![A triangulated scan-like sphere in Blender, before N-gons to Quads, covered in a regular pattern of triangles](\u002Fmedia\u002Fquadfix-scan-to-quads-before.jpg)\n\n![The same sphere after N-gons to Quads: most triangles are joined into quads, a few triangles remain in red](\u002Fmedia\u002Fquadfix-scan-to-quads-after.jpg)\n\n## What it does not do\n\nQuadFix repairs the mesh you have. It is not an auto-retopology tool and it does not rebuild edge flow.\n\n- Very irregular scans keep some triangles. The result line in the panel tells you how many remain.\n- Fill Holes skips the outer border of a flat open sheet, such as a plane or a terrain, and skips holes that are only partly selected.\n- Bridge to Quads refuses edge counts further apart than 4 to 1, loops that touch themselves, and selections with more than two loops or chains. Instead of guessing, it stops, selects the problem edges and leaves the mesh unchanged.\n- Union to Quads needs closed meshes that overlap. It does not generate UVs for the new strip. A seam that runs through a hole in your input stays a plain Boolean, and the report says how many seams were left that way. Strips on dense meshes with very different densities on the two sides are all quads but can zig-zag.\n\nThe [troubleshooting page](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting) lists the messages you can see and what to do about each.\n\n## Requirements\n\nBlender 4.2 or newer. Tested on Blender 4.2, 4.5 and 5.2. The add-on is a Blender extension, installed from a .zip file, and it needs no internet connection and no extra libraries. See [how to install QuadFix](\u002Fdocs\u002Fquadfix\u002Finstall). The licence is GPL-3.0-or-later.\n\n## Guides\n\n- [Fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads): the manual way first, then the one-click way.\n- [Convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and decide which n-gons to leave alone.\n- [Clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl) before you sculpt, UV or print it.\n\n## Free QuadFix Lite\n\nQuadFix Lite is a free, open-source cut of the add-on, available on [GitHub](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite). It has three tools: N-gons to Quads, Clean & Quad and Select Non-Quads & Holes, with the same options as the full version. It does not have Fill Holes with Quads, Bridge to Quads or Union to Quads, and it has no Match Triangle Meshes option. Its sidebar tab is called **QuadFix Lite**, so it can sit next to the full version. A side-by-side table is on the [install page](\u002Fdocs\u002Fquadfix\u002Finstall).\n\n## How to buy\n\nQuadFix costs $12. You can get it on [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix) or on [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=quadfix). Both give you the same .zip. Free updates are included for the 1.x line. Questions go to support@mendboxstudio.com. Built and tested by Pavel at Mendbox Studio ([about](\u002Fabout)).\n\nAfter purchase, follow the [install steps](\u002Fdocs\u002Fquadfix\u002Finstall), then open the [documentation overview](\u002Fdocs\u002Fquadfix). The [changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog) lists every version.\n",{"title":727,"description":945},"addons\u002Fquadfix","1.4.5","\u002Fmedia\u002Fquadfix.mp4","amZYvMitLwbhp1ca_RA8Ya1NuxulM6mN0AUqALtM3qg",[959,1161,1322,1485,1707,1985,2229,2943,3529,4126,4395,4741,5080,5304,5547,5921,6064],{"id":960,"title":961,"addon":962,"body":963,"description":1154,"extension":403,"meta":1155,"navigation":408,"order":1156,"path":347,"rawbody":1157,"seo":1158,"stem":1159,"updated":417,"__hash__":1160},"docs\u002Fdocs\u002Fbedsplit\u002Findex.md","BedSplit documentation","bedsplit",{"type":9,"value":964,"toc":1143},[965,969,975,979,1015,1019,1049,1053,1064,1067,1072,1075,1115,1123,1127],[12,966,968],{"id":967},"what-bedsplit-is","What BedSplit is",[17,970,971,972,90],{},"BedSplit is a Blender 4.2+ extension that takes a mesh that is too big for your 3D printer and turns it into closed parts that each fit the build volume. It places flat cuts, drills round dowel sockets into the joints, repairs the mesh first, lays every part flat and exports one STL per part. The product overview is on the ",[86,973,974],{"href":409},"BedSplit page",[12,976,978],{"id":977},"the-idea-in-five-steps","The idea in five steps",[980,981,982,988,991,997,1003],"ol",{},[36,983,984,985,987],{},"Select your model in Object Mode and open the ",[28,986,407],{}," tab in the sidebar.",[36,989,990],{},"Choose your printer, or type a custom bed size.",[36,992,993,994,996],{},"Optionally turn on ",[28,995,190],{}," and type the real longest side in millimetres.",[36,998,999,1000,1002],{},"Optionally press ",[28,1001,50],{}," and move, add or remove cut planes.",[36,1004,1005,1006,1008,1009,1012,1013,90],{},"Press ",[28,1007,30],{},", check the ",[28,1010,1011],{},"Result"," panel, then ",[28,1014,290],{},[12,1016,1018],{"id":1017},"documentation-pages","Documentation pages",[33,1020,1021,1027,1032,1038,1043],{},[36,1022,1023,1026],{},[86,1024,1025],{"href":294},"Install",": installing from disk, where the panel appears, updating, uninstalling, Lite versus the full version.",[36,1028,1029,1031],{},[86,1030,358],{"href":88},": every control, its default and its range, plus the printer preset table.",[36,1033,1034,1037],{},[86,1035,1036],{"href":363},"Workflows",": fitting a figure to a 220 mm bed, choosing cuts, adding dowels, exporting and assembling.",[36,1039,1040,1042],{},[86,1041,370],{"href":369},": non-manifold meshes, wrong scale, parts that are still too big, dowels in thin walls and more.",[36,1044,1045,1048],{},[86,1046,376],{"href":1047},"#version-history",": what each release contained.",[12,1050,1052],{"id":1051},"good-to-know-before-you-start","Good to know before you start",[33,1054,1055,1058,1061],{},[36,1056,1057],{},"The model must be a mesh object. If an imported file puts the mesh under an empty parent, BedSplit finds the only mesh selected, or the only mesh under the active object.",[36,1059,1060],{},"The original is never changed. The parts are new objects in a collection named after the source.",[36,1062,1063],{},"Everything is done in millimetres. The cutting positions you see are millimetres from the start of the model along each axis.",[12,1065,376],{"id":1066},"version-history",[1068,1069,1071],"h3",{"id":1070},"_013-13-november-2026","0.1.3 (13 November 2026)",[17,1073,1074],{},"The first public release, tagged v0.1.3 and sold on Gumroad. It needs Blender 4.2.0 or newer. It contains:",[33,1076,1077,1080,1084,1089,1100,1103,1106,1112],{},[36,1078,1079],{},"18 printer presets and a custom bed size.",[36,1081,1082,90],{},[28,1083,190],{},[36,1085,1086,1088],{},[28,1087,30],{}," with automatic cut planes along X, Y and Z.",[36,1090,1091,1093,1094,612,1097,90],{},[28,1092,50],{},", with planes drawn in the viewport, editable positions, ",[28,1095,1096],{},"Add Cut",[28,1098,1099],{},"Remove Cut",[36,1101,1102],{},"Round dowel sockets with settings for diameter, depth, clearance and dowels per joint.",[36,1104,1105],{},"Repair of holes, flipped normals, overlapping shells and non-manifold geometry before cutting.",[36,1107,1108,1109,1111],{},"Parts laid flat beside the source, and a ",[28,1110,1011],{}," panel with size and checks per part.",[36,1113,1114],{},"Export of one STL per part and one dowel file.",[17,1116,1117,1118,1122],{},"The free ",[86,1119,1121],{"href":314,"rel":1120},[316],"BedSplit Lite"," covers flat cuts without dowels, repair or cut preview.",[12,1124,1126],{"id":1125},"related","Related",[33,1128,1129,1134,1138],{},[36,1130,1131,1132],{},"Product page: ",[86,1133,407],{"href":409},[36,1135,1136],{},[86,1137,370],{"href":369},[36,1139,379,1140,1142],{},[86,1141,383],{"href":382},", manual method first, then the add-on",{"title":386,"searchDepth":387,"depth":387,"links":1144},[1145,1146,1147,1148,1149,1153],{"id":967,"depth":387,"text":968},{"id":977,"depth":387,"text":978},{"id":1017,"depth":387,"text":1018},{"id":1051,"depth":387,"text":1052},{"id":1066,"depth":387,"text":376,"children":1150},[1151],{"id":1070,"depth":1152,"text":1071},3,{"id":1125,"depth":387,"text":1126},"Documentation for BedSplit, the Blender add-on that splits a model to fit your 3D printer bed: dowel sockets, mesh repair, STL export and the version history.",{},1,"---\ntitle: \"BedSplit documentation\"\ndescription: \"Documentation for BedSplit, the Blender add-on that splits a model to fit your 3D printer bed: dowel sockets, mesh repair, STL export and the version history.\"\naddon: bedsplit\norder: 1\nupdated: 2026-11-16\n---\n\n## What BedSplit is\n\nBedSplit is a Blender 4.2+ extension that takes a mesh that is too big for your 3D printer and turns it into closed parts that each fit the build volume. It places flat cuts, drills round dowel sockets into the joints, repairs the mesh first, lays every part flat and exports one STL per part. The product overview is on the [BedSplit page](\u002Faddons\u002Fbedsplit).\n\n## The idea in five steps\n\n1. Select your model in Object Mode and open the **BedSplit** tab in the sidebar.\n2. Choose your printer, or type a custom bed size.\n3. Optionally turn on **Resize for print** and type the real longest side in millimetres.\n4. Optionally press **Find Cuts** and move, add or remove cut planes.\n5. Press **Split to Bed**, check the **Result** panel, then **Export STL**.\n\n## Documentation pages\n\n- [Install](\u002Fdocs\u002Fbedsplit\u002Finstall): installing from disk, where the panel appears, updating, uninstalling, Lite versus the full version.\n- [Panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel): every control, its default and its range, plus the printer preset table.\n- [Workflows](\u002Fdocs\u002Fbedsplit\u002Fworkflows): fitting a figure to a 220 mm bed, choosing cuts, adding dowels, exporting and assembling.\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting): non-manifold meshes, wrong scale, parts that are still too big, dowels in thin walls and more.\n- [Version history](#version-history): what each release contained.\n\n## Good to know before you start\n\n- The model must be a mesh object. If an imported file puts the mesh under an empty parent, BedSplit finds the only mesh selected, or the only mesh under the active object.\n- The original is never changed. The parts are new objects in a collection named after the source.\n- Everything is done in millimetres. The cutting positions you see are millimetres from the start of the model along each axis.\n\n## Version history\n\n### 0.1.3 (13 November 2026)\n\nThe first public release, tagged v0.1.3 and sold on Gumroad. It needs Blender 4.2.0 or newer. It contains:\n\n- 18 printer presets and a custom bed size.\n- **Resize for print**.\n- **Split to Bed** with automatic cut planes along X, Y and Z.\n- **Find Cuts**, with planes drawn in the viewport, editable positions, **Add Cut** and **Remove Cut**.\n- Round dowel sockets with settings for diameter, depth, clearance and dowels per joint.\n- Repair of holes, flipped normals, overlapping shells and non-manifold geometry before cutting.\n- Parts laid flat beside the source, and a **Result** panel with size and checks per part.\n- Export of one STL per part and one dowel file.\n\nThe free [BedSplit Lite](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fbedsplit-lite\u002Freleases\u002Flatest) covers flat cuts without dowels, repair or cut preview.\n\n## Related\n\n- Product page: [BedSplit](\u002Faddons\u002Fbedsplit)\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting)\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing), manual method first, then the add-on\n",{"title":961,"description":1154},"docs\u002Fbedsplit\u002Findex","tjJjN81j9LymHr9SmPn8BS2C538P_Rg891o4joq2Ybw",{"id":1162,"title":1163,"addon":1164,"body":1165,"description":1316,"extension":403,"meta":1317,"navigation":408,"order":1156,"path":687,"rawbody":1318,"seo":1319,"stem":1320,"updated":417,"__hash__":1321},"docs\u002Fdocs\u002Fimage-per-instance\u002Findex.md","Image Per Instance documentation","image-per-instance",{"type":9,"value":1166,"toc":1309},[1167,1171,1176,1179,1183,1243,1247,1277,1283,1287,1293,1295],[12,1168,1170],{"id":1169},"what-this-add-on-does","What this add-on does",[17,1172,1173,1175],{},[86,1174,715],{"href":716}," puts a different image on every object, array element or Geometry Nodes instance while all of them share one material. It reads a folder of images, packs them into one atlas stored in your .blend file, and stores an image number on each object or instance. The material reads that number and shows the matching tile.",[17,1177,1178],{},"This documentation covers version 0.2.0 for Blender 4.2 and newer.",[12,1180,1182],{"id":1181},"pages","Pages",[106,1184,1185,1195],{},[109,1186,1187],{},[112,1188,1189,1192],{},[115,1190,1191],{},"Page",[115,1193,1194],{},"What is in it",[122,1196,1197,1206,1215,1224,1233],{},[112,1198,1199,1203],{},[127,1200,1201],{},[86,1202,1025],{"href":657},[127,1204,1205],{},"Installing the zip, where the panel is, updating, removing, Lite versus full",[112,1207,1208,1212],{},[127,1209,1210],{},[86,1211,358],{"href":551},[127,1213,1214],{},"Every field, button and option with defaults and ranges",[112,1216,1217,1221],{},[127,1218,1219],{},[86,1220,1036],{"href":561},[127,1222,1223],{},"Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes",[112,1225,1226,1230],{},[127,1227,1228],{},[86,1229,370],{"href":628},[127,1231,1232],{},"Error messages and limits, and what to do about each",[112,1234,1235,1240],{},[127,1236,1237],{},[86,1238,1239],{"href":692},"Changelog",[127,1241,1242],{},"What changed in each version",[12,1244,1246],{"id":1245},"the-idea-in-one-minute","The idea in one minute",[980,1248,1249,1262,1268],{},[36,1250,1251,1252,1255,1256,1259,1260,90],{},"Choose an ",[28,1253,1254],{},"Image Folder"," and a ",[28,1257,1258],{},"Tile Size",", then press ",[28,1261,436],{},[36,1263,1264,1265,1267],{},"If the pictures go on separate meshes, select those meshes and press ",[28,1266,468],{},". Each one gets its own tile.",[36,1269,1270,1271,1273,1274,1276],{},"If you use an Array modifier or Instance on Points, click the host object so it is active and press ",[28,1272,474],{},". The add-on finds the objects being instanced, gives them the shared material and adds an ",[28,1275,478],{}," modifier to the host.",[17,1278,1279,1280,1282],{},"If you are new to the problem, read the guide ",[86,1281,567],{"href":566}," first. It explains the manual method and why an atlas helps.",[12,1284,1286],{"id":1285},"support","Support",[17,1288,1289,1290,1292],{},"Write to ",[86,1291,912],{"href":911}," and include your Blender version, the add-on version shown at the bottom of the panel, and the message Blender showed.",[12,1294,1126],{"id":1125},[33,1296,1297,1301,1305],{},[36,1298,1131,1299],{},[86,1300,715],{"href":716},[36,1302,1303],{},[86,1304,370],{"href":628},[36,1306,379,1307],{},[86,1308,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":1310},[1311,1312,1313,1314,1315],{"id":1169,"depth":387,"text":1170},{"id":1181,"depth":387,"text":1182},{"id":1245,"depth":387,"text":1246},{"id":1285,"depth":387,"text":1286},{"id":1125,"depth":387,"text":1126},"Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.",{},"---\ntitle: \"Image Per Instance documentation\"\ndescription: \"Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.\"\naddon: image-per-instance\norder: 1\nupdated: 2026-11-16\n---\n\n## What this add-on does\n\n[Image Per Instance](\u002Faddons\u002Fimage-per-instance) puts a different image on every object, array element or Geometry Nodes instance while all of them share one material. It reads a folder of images, packs them into one atlas stored in your .blend file, and stores an image number on each object or instance. The material reads that number and shows the matching tile.\n\nThis documentation covers version 0.2.0 for Blender 4.2 and newer.\n\n## Pages\n\n| Page | What is in it |\n|---|---|\n| [Install](\u002Fdocs\u002Fimage-per-instance\u002Finstall) | Installing the zip, where the panel is, updating, removing, Lite versus full |\n| [Panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) | Every field, button and option with defaults and ranges |\n| [Workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows) | Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes |\n| [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting) | Error messages and limits, and what to do about each |\n| [Changelog](\u002Fdocs\u002Fimage-per-instance\u002Fchangelog) | What changed in each version |\n\n## The idea in one minute\n\n1. Choose an **Image Folder** and a **Tile Size**, then press **Build Atlas**.\n2. If the pictures go on separate meshes, select those meshes and press **Apply To Selected Objects**. Each one gets its own tile.\n3. If you use an Array modifier or Instance on Points, click the host object so it is active and press **Add To Instances (Geometry Nodes)**. The add-on finds the objects being instanced, gives them the shared material and adds an **IPI Assign Index** modifier to the host.\n\nIf you are new to the problem, read the guide [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance) first. It explains the manual method and why an atlas helps.\n\n## Support\n\nWrite to support@mendboxstudio.com and include your Blender version, the add-on version shown at the bottom of the panel, and the message Blender showed.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1163,"description":1316},"docs\u002Fimage-per-instance\u002Findex","nvPcxYtdq4OoSWwvD1tI5AeAY9jaK-lqeCAIxutySt0",{"id":1323,"title":1324,"addon":1325,"body":1326,"description":1479,"extension":403,"meta":1480,"navigation":408,"order":1156,"path":925,"rawbody":1481,"seo":1482,"stem":1483,"updated":417,"__hash__":1484},"docs\u002Fdocs\u002Fquadfix\u002Findex.md","QuadFix documentation","quadfix",{"type":9,"value":1327,"toc":1471},[1328,1332,1338,1342,1369,1371,1413,1419,1421,1424,1438,1442,1447,1449],[12,1329,1331],{"id":1330},"what-quadfix-is","What QuadFix is",[17,1333,1334,1335,90],{},"QuadFix is a Blender add-on for repairing meshes with quads. It fills holes, bridges edge loops, converts triangles and n-gons, cleans up Boolean and imported meshes and unions objects with a clean seam. This documentation covers version 1.4.5 on Blender 4.2 and newer. For a short pitch and the price, see the ",[86,1336,1337],{"href":949},"QuadFix product page",[12,1339,1341],{"id":1340},"contents","Contents",[33,1343,1344,1349,1354,1359,1364],{},[36,1345,1346,1348],{},[86,1347,1025],{"href":845},": install from the .zip, find the panel, update, uninstall, and compare Lite with the full version.",[36,1350,1351,1353],{},[86,1352,358],{"href":792},": every panel, button and option with defaults and ranges.",[36,1355,1356,1358],{},[86,1357,1036],{"href":796},": step-by-step recipes for filling a hole, bridging two loops, cleaning after a Boolean, converting n-gons and joining objects.",[36,1360,1361,1363],{},[86,1362,370],{"href":835},": the messages you can see and how to fix each cause.",[36,1365,1366,1368],{},[86,1367,1239],{"href":929},": what changed in each version.",[12,1370,1246],{"id":1245},[980,1372,1373,1383,1390,1395,1402],{},[36,1374,1375,1376,1379,1380,1382],{},"Open the 3D viewport sidebar with ",[456,1377,1378],{},"N"," and choose the ",[28,1381,747],{}," tab.",[36,1384,1385,1386,1389],{},"Select a mesh object and press ",[456,1387,1388],{},"Tab"," for Edit Mode.",[36,1391,1005,1392,1394],{},[28,1393,779],{}," to see what is wrong. The counts appear at the bottom of the panel.",[36,1396,1397,1398,1401],{},"Select the part you want to fix, or press ",[456,1399,1400],{},"A"," for everything, and press the tool you need.",[36,1403,1404,1405,1408,1409,1412],{},"Read the last-result line at the bottom of the panel. ",[456,1406,1407],{},"Ctrl+Z"," (",[456,1410,1411],{},"Cmd+Z"," on Mac) undoes the step.",[17,1414,832,1415,1418],{},[28,1416,1417],{},"Only Selected"," option is on by default, so a tool only touches the selection. Turn it off to work on the whole mesh.",[12,1420,851],{"id":850},[17,1422,1423],{},"Longer how-to articles that start with the manual Blender method:",[33,1425,1426,1430,1434],{},[36,1427,1428],{},[86,1429,859],{"href":858},[36,1431,1432],{},[86,1433,866],{"href":865},[36,1435,1436],{},[86,1437,873],{"href":872},[12,1439,1441],{"id":1440},"not-what-it-is-for","Not what it is for",[17,1443,1444,1445,90],{},"QuadFix repairs what is there. It is not a remesher and it does not rebuild edge flow. See the limits listed per tool in the ",[86,1446,89],{"href":792},[12,1448,1126],{"id":1125},[33,1450,1451,1455,1459],{},[36,1452,1131,1453],{},[86,1454,747],{"href":949},[36,1456,1457],{},[86,1458,370],{"href":835},[36,1460,1461,1462,305,1465,612,1468],{},"Guides: ",[86,1463,1464],{"href":858},"fill a hole with quads",[86,1466,1467],{"href":865},"convert n-gons to quads",[86,1469,1470],{"href":872},"clean up an imported STL",{"title":386,"searchDepth":387,"depth":387,"links":1472},[1473,1474,1475,1476,1477,1478],{"id":1330,"depth":387,"text":1331},{"id":1340,"depth":387,"text":1341},{"id":1245,"depth":387,"text":1246},{"id":850,"depth":387,"text":851},{"id":1440,"depth":387,"text":1441},{"id":1125,"depth":387,"text":1126},"Documentation for the QuadFix Blender add-on: install, every panel option, step-by-step workflows, troubleshooting for each message and the full changelog.",{},"---\ntitle: \"QuadFix documentation\"\ndescription: \"Documentation for the QuadFix Blender add-on: install, every panel option, step-by-step workflows, troubleshooting for each message and the full changelog.\"\naddon: quadfix\norder: 1\nupdated: 2026-11-16\n---\n\n## What QuadFix is\n\nQuadFix is a Blender add-on for repairing meshes with quads. It fills holes, bridges edge loops, converts triangles and n-gons, cleans up Boolean and imported meshes and unions objects with a clean seam. This documentation covers version 1.4.5 on Blender 4.2 and newer. For a short pitch and the price, see the [QuadFix product page](\u002Faddons\u002Fquadfix).\n\n## Contents\n\n- [Install](\u002Fdocs\u002Fquadfix\u002Finstall): install from the .zip, find the panel, update, uninstall, and compare Lite with the full version.\n- [Panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel): every panel, button and option with defaults and ranges.\n- [Workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows): step-by-step recipes for filling a hole, bridging two loops, cleaning after a Boolean, converting n-gons and joining objects.\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting): the messages you can see and how to fix each cause.\n- [Changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog): what changed in each version.\n\n## The idea in one minute\n\n1. Open the 3D viewport sidebar with `N` and choose the **QuadFix** tab.\n2. Select a mesh object and press `Tab` for Edit Mode.\n3. Press **Select Non-Quads & Holes** to see what is wrong. The counts appear at the bottom of the panel.\n4. Select the part you want to fix, or press `A` for everything, and press the tool you need.\n5. Read the last-result line at the bottom of the panel. `Ctrl+Z` (`Cmd+Z` on Mac) undoes the step.\n\nThe **Only Selected** option is on by default, so a tool only touches the selection. Turn it off to work on the whole mesh.\n\n## Guides\n\nLonger how-to articles that start with the manual Blender method:\n\n- [Fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads)\n- [Convert n-gons to quads](\u002Fguides\u002Fngons-to-quads)\n- [Clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n\n## Not what it is for\n\nQuadFix repairs what is there. It is not a remesher and it does not rebuild edge flow. See the limits listed per tool in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":1324,"description":1479},"docs\u002Fquadfix\u002Findex","NGk1W3281NMRBq-f-v1Sqme11QIKCV7-p8kWI6tYJuc",{"id":1486,"title":1487,"addon":962,"body":1488,"description":1701,"extension":403,"meta":1702,"navigation":408,"order":387,"path":294,"rawbody":1703,"seo":1704,"stem":1705,"updated":417,"__hash__":1706},"docs\u002Fdocs\u002Fbedsplit\u002Finstall.md","Install BedSplit in Blender",{"type":9,"value":1489,"toc":1692},[1490,1492,1495,1499,1522,1526,1544,1551,1555,1561,1565,1571,1575,1581,1663,1676,1678],[12,1491,284],{"id":283},[17,1493,1494],{},"BedSplit is a Blender extension and needs Blender 4.2.0 or newer. It was tested on 4.2, 4.5 and 5.2. The add-on is licensed GPL-3.0-or-later. Its only permission request is writing files, which it uses for the STL export.",[12,1496,1498],{"id":1497},"install-from-disk","Install from disk",[980,1500,1501,1504,1510,1516,1519],{},[36,1502,1503],{},"Download the zip after your purchase. Do not unzip it.",[36,1505,1506,1507,90],{},"In Blender open ",[28,1508,1509],{},"Edit > Preferences > Get Extensions",[36,1511,1512,1513,90],{},"Open the small arrow menu at the top right and choose ",[28,1514,1515],{},"Install from Disk",[36,1517,1518],{},"Pick the downloaded zip file and confirm.",[36,1520,1521],{},"Make sure the extension is enabled in the list.",[12,1523,1525],{"id":1524},"where-the-panel-appears","Where the panel appears",[17,1527,1528,1529,1531,1532,1534,1535,1537,1538,1540,1541,1543],{},"Open a 3D Viewport, press ",[28,1530,1378],{}," to show the sidebar, and click the ",[28,1533,407],{}," tab. The tab holds two panels: ",[28,1536,407],{}," with the settings and the ",[28,1539,30],{}," button, and below it a ",[28,1542,1011],{}," panel whose title also shows the installed version, for example \"Result  ·  BedSplit v0.1.3\".",[17,1545,1546,1547,1550],{},"The panels are only shown in ",[28,1548,1549],{},"Object Mode",". If the tab seems missing, leave Edit Mode first.",[12,1552,1554],{"id":1553},"update","Update",[17,1556,1557,1558,1560],{},"Download the new zip and install it from disk in the same way, then check the version in the title of the ",[28,1559,1011],{}," panel. Updates are free.",[12,1562,1564],{"id":1563},"uninstall","Uninstall",[17,1566,1567,1568,1570],{},"Open ",[28,1569,1509],{},", find BedSplit in the list, and remove it. Parts and dowels you already created are ordinary objects and stay in your scene.",[12,1572,1574],{"id":1573},"lite-versus-the-full-version","Lite versus the full version",[17,1576,1577,1578,1580],{},"BedSplit Lite is a separate free extension with its own tab named ",[28,1579,1121],{},". You can have both installed.",[106,1582,1583,1595],{},[109,1584,1585],{},[112,1586,1587,1590,1593],{},[115,1588,1589],{},"Feature",[115,1591,1592],{},"Lite",[115,1594,407],{},[122,1596,1597,1607,1615,1624,1633,1643,1653],{},[112,1598,1599,1602,1605],{},[127,1600,1601],{},"Printer presets and custom bed size",[127,1603,1604],{},"yes",[127,1606,1604],{},[112,1608,1609,1611,1613],{},[127,1610,190],{},[127,1612,1604],{},[127,1614,1604],{},[112,1616,1617,1620,1622],{},[127,1618,1619],{},"Split to Bed with flat cuts, closed parts",[127,1621,1604],{},[127,1623,1604],{},[112,1625,1626,1629,1631],{},[127,1627,1628],{},"Parts laid flat, per-part STL export",[127,1630,1604],{},[127,1632,1604],{},[112,1634,1635,1638,1641],{},[127,1636,1637],{},"Dowels and sockets, dowel settings",[127,1639,1640],{},"no",[127,1642,1604],{},[112,1644,1645,1648,1651],{},[127,1646,1647],{},"Mesh repair (holes, normals, overlapping shells, AI meshes)",[127,1649,1650],{},"no, watertight meshes only",[127,1652,1604],{},[112,1654,1655,1658,1661],{},[127,1656,1657],{},"Find Cuts and movable cut planes",[127,1659,1660],{},"no, automatic cuts only",[127,1662,1604],{},[17,1664,1665,1666,1669,1670,1672,1673,90],{},"Get Lite from the ",[86,1667,317],{"href":314,"rel":1668},[316],". Next: the ",[86,1671,89],{"href":88}," or the ",[86,1674,1675],{"href":363},"workflows",[12,1677,1126],{"id":1125},[33,1679,1680,1684,1688],{},[36,1681,1131,1682],{},[86,1683,407],{"href":409},[36,1685,1686],{},[86,1687,370],{"href":369},[36,1689,379,1690],{},[86,1691,383],{"href":382},{"title":386,"searchDepth":387,"depth":387,"links":1693},[1694,1695,1696,1697,1698,1699,1700],{"id":283,"depth":387,"text":284},{"id":1497,"depth":387,"text":1498},{"id":1524,"depth":387,"text":1525},{"id":1553,"depth":387,"text":1554},{"id":1563,"depth":387,"text":1564},{"id":1573,"depth":387,"text":1574},{"id":1125,"depth":387,"text":1126},"Install the BedSplit extension from disk in Blender 4.2 or newer, find the BedSplit tab, update or uninstall it, and see how it differs from BedSplit Lite.",{},"---\ntitle: \"Install BedSplit in Blender\"\ndescription: \"Install the BedSplit extension from disk in Blender 4.2 or newer, find the BedSplit tab, update or uninstall it, and see how it differs from BedSplit Lite.\"\naddon: bedsplit\norder: 2\nupdated: 2026-11-16\n---\n\n## Requirements\n\nBedSplit is a Blender extension and needs Blender 4.2.0 or newer. It was tested on 4.2, 4.5 and 5.2. The add-on is licensed GPL-3.0-or-later. Its only permission request is writing files, which it uses for the STL export.\n\n## Install from disk\n\n1. Download the zip after your purchase. Do not unzip it.\n2. In Blender open **Edit > Preferences > Get Extensions**.\n3. Open the small arrow menu at the top right and choose **Install from Disk**.\n4. Pick the downloaded zip file and confirm.\n5. Make sure the extension is enabled in the list.\n\n## Where the panel appears\n\nOpen a 3D Viewport, press **N** to show the sidebar, and click the **BedSplit** tab. The tab holds two panels: **BedSplit** with the settings and the **Split to Bed** button, and below it a **Result** panel whose title also shows the installed version, for example \"Result  ·  BedSplit v0.1.3\".\n\nThe panels are only shown in **Object Mode**. If the tab seems missing, leave Edit Mode first.\n\n## Update\n\nDownload the new zip and install it from disk in the same way, then check the version in the title of the **Result** panel. Updates are free.\n\n## Uninstall\n\nOpen **Edit > Preferences > Get Extensions**, find BedSplit in the list, and remove it. Parts and dowels you already created are ordinary objects and stay in your scene.\n\n## Lite versus the full version\n\nBedSplit Lite is a separate free extension with its own tab named **BedSplit Lite**. You can have both installed.\n\n| Feature | Lite | BedSplit |\n|---|---|---|\n| Printer presets and custom bed size | yes | yes |\n| Resize for print | yes | yes |\n| Split to Bed with flat cuts, closed parts | yes | yes |\n| Parts laid flat, per-part STL export | yes | yes |\n| Dowels and sockets, dowel settings | no | yes |\n| Mesh repair (holes, normals, overlapping shells, AI meshes) | no, watertight meshes only | yes |\n| Find Cuts and movable cut planes | no, automatic cuts only | yes |\n\nGet Lite from the [BedSplit Lite releases page](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fbedsplit-lite\u002Freleases\u002Flatest). Next: the [panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel) or the [workflows](\u002Fdocs\u002Fbedsplit\u002Fworkflows).\n\n## Related\n\n- Product page: [BedSplit](\u002Faddons\u002Fbedsplit)\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting)\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing)\n",{"title":1487,"description":1701},"docs\u002Fbedsplit\u002Finstall","UW_fypjoS1jOwhTiAcAZXJ9mKD9W0xT9xfs3aaQxEBU",{"id":1708,"title":1709,"addon":1164,"body":1710,"description":1979,"extension":403,"meta":1980,"navigation":408,"order":387,"path":657,"rawbody":1981,"seo":1982,"stem":1983,"updated":417,"__hash__":1984},"docs\u002Fdocs\u002Fimage-per-instance\u002Finstall.md","Install Image Per Instance in Blender",{"type":9,"value":1711,"toc":1970},[1712,1714,1717,1719,1736,1740,1755,1773,1775,1784,1786,1806,1810,1819,1944,1947,1954,1956],[12,1713,284],{"id":283},[17,1715,1716],{},"Blender 4.2 or newer. The add-on is distributed as an extension zip. It has no external dependencies, needs no internet connection and installs no extra software.",[12,1718,1498],{"id":1497},[980,1720,1721,1724,1728,1733],{},[36,1722,1723],{},"Download the zip from Gumroad or Superhive. Do not unzip it.",[36,1725,1506,1726,90],{},[28,1727,1509],{},[36,1729,1730,1731,90],{},"Open the arrow menu at the top right and choose ",[28,1732,1515],{},[36,1734,1735],{},"Pick the zip file.",[12,1737,1739],{"id":1738},"where-the-panel-is","Where the panel is",[17,1741,1742,1743,1745,1746,1748,1749,1751,1752,90],{},"Hover over the 3D viewport and press ",[28,1744,1378],{}," to open the sidebar. The add-on has its own tab named ",[28,1747,715],{},". The panel inside it is called ",[28,1750,715],{},", and the version number is shown at the bottom, for example ",[456,1753,1754],{},"Image Per Instance v0.2.0",[17,1756,1757,1758,305,1761,305,1764,612,1767,684,1770,1772],{},"Four sub-panels sit below the main buttons and start collapsed: ",[28,1759,1760],{},"Choose Images Yourself",[28,1762,1763],{},"Material",[28,1765,1766],{},"Animate",[28,1768,1769],{},"Random Variation",[86,1771,89],{"href":551}," describes all of them.",[12,1774,1554],{"id":1553},[17,1776,1777,1778,1780,1781,1783],{},"Install the newer zip with ",[28,1779,1515],{}," in the same way. Check the version at the bottom of the panel afterwards. Pressing ",[28,1782,436],{}," again keeps each object's picture when the file names are the same.",[12,1785,1564],{"id":1563},[17,1787,1567,1788,1790,1791,1794,1795,1798,1799,1802,1803,1805],{},[28,1789,1509],{},", find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material ",[456,1792,1793],{},"IPI_Material",", the atlas image ",[456,1796,1797],{},"IPI_Atlas",", a custom property ",[456,1800,1801],{},"img_index"," on separate objects, and a modifier named ",[456,1804,478],{}," on instance hosts. You can delete these by hand if you no longer need them.",[12,1807,1809],{"id":1808},"lite-versus-full","Lite versus full",[17,1811,1117,1812,1816,1817,90],{},[86,1813,1815],{"href":651,"rel":1814},[316],"Image Per Instance Lite"," is a separate download. Its tab is named ",[28,1818,1815],{},[106,1820,1821,1832],{},[109,1822,1823],{},[112,1824,1825,1827,1829],{},[115,1826,1589],{},[115,1828,1592],{},[115,1830,1831],{},"Full",[122,1833,1834,1843,1852,1863,1872,1881,1890,1899,1908,1917,1926,1935],{},[112,1835,1836,1839,1841],{},[127,1837,1838],{},"Build Atlas from a folder, Apply To Selected Objects",[127,1840,1604],{},[127,1842,1604],{},[112,1844,1845,1848,1850],{},[127,1846,1847],{},"One shared material",[127,1849,1604],{},[127,1851,1604],{},[112,1853,1854,1857,1860],{},[127,1855,1856],{},"Images per atlas",[127,1858,1859],{},"up to 20",[127,1861,1862],{},"no limit in the add-on",[112,1864,1865,1868,1870],{},[127,1866,1867],{},"Natural file order",[127,1869,1604],{},[127,1871,1604],{},[112,1873,1874,1877,1879],{},[127,1875,1876],{},"Geometry Nodes instances, Array modifier",[127,1878,1640],{},[127,1880,1604],{},[112,1882,1883,1886,1888],{},[127,1884,1885],{},"Shuffle",[127,1887,1640],{},[127,1889,1604],{},[112,1891,1892,1895,1897],{},[127,1893,1894],{},"Tile shape and fit modes",[127,1896,1640],{},[127,1898,1604],{},[112,1900,1901,1904,1906],{},[127,1902,1903],{},"Assign by number, name or picker",[127,1905,1640],{},[127,1907,1604],{},[112,1909,1910,1913,1915],{},[127,1911,1912],{},"Alpha and emission",[127,1914,1640],{},[127,1916,1604],{},[112,1918,1919,1922,1924],{},[127,1920,1921],{},"Mapping without UVs",[127,1923,1640],{},[127,1925,1604],{},[112,1927,1928,1931,1933],{},[127,1929,1930],{},"Animation",[127,1932,1640],{},[127,1934,1604],{},[112,1936,1937,1940,1942],{},[127,1938,1939],{},"Random variation",[127,1941,1640],{},[127,1943,1604],{},[17,1945,1946],{},"When Lite finds more than 20 images, it stops with the message \"This free version supports up to 20 images\".",[17,1948,1949,1950,1672,1952,90],{},"Next: the ",[86,1951,89],{"href":551},[86,1953,1675],{"href":561},[12,1955,1126],{"id":1125},[33,1957,1958,1962,1966],{},[36,1959,1131,1960],{},[86,1961,715],{"href":716},[36,1963,1964],{},[86,1965,370],{"href":628},[36,1967,379,1968],{},[86,1969,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":1971},[1972,1973,1974,1975,1976,1977,1978],{"id":283,"depth":387,"text":284},{"id":1497,"depth":387,"text":1498},{"id":1738,"depth":387,"text":1739},{"id":1553,"depth":387,"text":1554},{"id":1563,"depth":387,"text":1564},{"id":1808,"depth":387,"text":1809},{"id":1125,"depth":387,"text":1126},"How to install, find, update and remove the Image Per Instance add-on in Blender 4.2 and newer, and how the free Lite version differs from the full one.",{},"---\ntitle: \"Install Image Per Instance in Blender\"\ndescription: \"How to install, find, update and remove the Image Per Instance add-on in Blender 4.2 and newer, and how the free Lite version differs from the full one.\"\naddon: image-per-instance\norder: 2\nupdated: 2026-11-16\n---\n\n## Requirements\n\nBlender 4.2 or newer. The add-on is distributed as an extension zip. It has no external dependencies, needs no internet connection and installs no extra software.\n\n## Install from disk\n\n1. Download the zip from Gumroad or Superhive. Do not unzip it.\n2. In Blender open **Edit > Preferences > Get Extensions**.\n3. Open the arrow menu at the top right and choose **Install from Disk**.\n4. Pick the zip file.\n\n## Where the panel is\n\nHover over the 3D viewport and press **N** to open the sidebar. The add-on has its own tab named **Image Per Instance**. The panel inside it is called **Image Per Instance**, and the version number is shown at the bottom, for example `Image Per Instance v0.2.0`.\n\nFour sub-panels sit below the main buttons and start collapsed: **Choose Images Yourself**, **Material**, **Animate** and **Random Variation**. The [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) describes all of them.\n\n## Update\n\nInstall the newer zip with **Install from Disk** in the same way. Check the version at the bottom of the panel afterwards. Pressing **Build Atlas** again keeps each object's picture when the file names are the same.\n\n## Uninstall\n\nOpen **Edit > Preferences > Get Extensions**, find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material `IPI_Material`, the atlas image `IPI_Atlas`, a custom property `img_index` on separate objects, and a modifier named `IPI Assign Index` on instance hosts. You can delete these by hand if you no longer need them.\n\n## Lite versus full\n\nThe free [Image Per Instance Lite](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite) is a separate download. Its tab is named **Image Per Instance Lite**.\n\n| Feature | Lite | Full |\n|---|---|---|\n| Build Atlas from a folder, Apply To Selected Objects | yes | yes |\n| One shared material | yes | yes |\n| Images per atlas | up to 20 | no limit in the add-on |\n| Natural file order | yes | yes |\n| Geometry Nodes instances, Array modifier | no | yes |\n| Shuffle | no | yes |\n| Tile shape and fit modes | no | yes |\n| Assign by number, name or picker | no | yes |\n| Alpha and emission | no | yes |\n| Mapping without UVs | no | yes |\n| Animation | no | yes |\n| Random variation | no | yes |\n\nWhen Lite finds more than 20 images, it stops with the message \"This free version supports up to 20 images\".\n\nNext: the [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) or the [workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows).\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1709,"description":1979},"docs\u002Fimage-per-instance\u002Finstall","XImq1D0SPLXcR1dDWHpVYP8bVTntBVzsgcH9KLvsNlA",{"id":1986,"title":1987,"addon":1325,"body":1988,"description":2223,"extension":403,"meta":2224,"navigation":408,"order":387,"path":845,"rawbody":2225,"seo":2226,"stem":2227,"updated":417,"__hash__":2228},"docs\u002Fdocs\u002Fquadfix\u002Finstall.md","Install QuadFix in Blender",{"type":9,"value":1989,"toc":2214},[1990,1992,1999,2003,2015,2032,2035,2037,2052,2062,2067,2069,2080,2082,2087,2091,2100,2184,2194,2196],[12,1991,284],{"id":283},[17,1993,1994,1995,1998],{},"QuadFix is a Blender extension and needs Blender 4.2 or newer. It uses only Blender's own Python and ",[456,1996,1997],{},"bmesh",", so there is nothing else to install and no internet connection is needed.",[12,2000,2002],{"id":2001},"install-from-the-zip","Install from the .zip",[17,2004,2005,2006,674,2010,2014],{},"Download the .zip from ",[86,2007,673],{"href":2008,"rel":2009},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[316],[86,2011,679],{"href":2012,"rel":2013},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix",[316],". Do not unzip it.",[980,2016,2017,2021,2026,2029],{},[36,2018,1506,2019,90],{},[28,2020,1509],{},[36,2022,2023,2024,90],{},"Click the small arrow menu at the top right of the window and choose ",[28,2025,1515],{},[36,2027,2028],{},"Pick the .zip file.",[36,2030,2031],{},"Make sure the add-on is enabled in the list.",[17,2033,2034],{},"Instead of steps 1 to 3 you can drag the .zip file into the Blender window and confirm the install.",[12,2036,1525],{"id":1524},[980,2038,2039,2042,2047],{},[36,2040,2041],{},"Select a mesh object in the 3D viewport.",[36,2043,1005,2044,2046],{},[456,2045,1378],{}," to open the sidebar.",[36,2048,2049,2050,90],{},"Open the tab named ",[28,2051,747],{},[17,2053,2054,2055,2057,2058,2061],{},"The tab is available in Object Mode and in Edit Mode. The mesh tools need Edit Mode and appear greyed out in Object Mode, with a note to press ",[456,2056,1388],{},". The union tool needs Object Mode and is greyed out in Edit Mode. At the bottom of the tab a footer panel shows the installed version, for example ",[456,2059,2060],{},"QuadFix v1.4.5",", and the result of the last operation.",[17,2063,2064,2065,90],{},"Everything is described in the ",[86,2066,89],{"href":792},[12,2068,1554],{"id":1553},[17,2070,1567,2071,2073,2074,2076,2077,2079],{},[28,2072,1509],{},", use ",[28,2075,1515],{}," with the new .zip and confirm that it replaces the old version. Updates for the 1.x line are free. The ",[86,2078,693],{"href":929}," lists what each version changed.",[12,2081,1564],{"id":1563},[17,2083,1567,2084,2086],{},[28,2085,1509],{},", find QuadFix in the list of installed extensions and remove it. Your meshes are not changed by removing the add-on.",[12,2088,2090],{"id":2089},"lite-or-full","Lite or full",[17,2092,1117,2093,2096,2097,2099],{},[86,2094,890],{"href":884,"rel":2095},[316]," is a separate extension. Its sidebar tab is named ",[28,2098,890],{},". Download its .zip from the Releases page on GitHub and install it the same way.",[106,2101,2102,2115],{},[109,2103,2104],{},[112,2105,2106,2109,2112],{},[115,2107,2108],{},"Tool",[115,2110,2111],{},"Lite (free)",[115,2113,2114],{},"Full ($12)",[122,2116,2117,2125,2133,2142,2151,2159,2168,2176],{},[112,2118,2119,2121,2123],{},[127,2120,779],{},[127,2122,1604],{},[127,2124,1604],{},[112,2126,2127,2129,2131],{},[127,2128,767],{},[127,2130,1604],{},[127,2132,1604],{},[112,2134,2135,2138,2140],{},[127,2136,2137],{},"Clean & Quad",[127,2139,1604],{},[127,2141,1604],{},[112,2143,2144,2147,2149],{},[127,2145,2146],{},"Only Selected, last-result report, undo",[127,2148,1604],{},[127,2150,1604],{},[112,2152,2153,2155,2157],{},[127,2154,755],{},[127,2156,1640],{},[127,2158,1604],{},[112,2160,2161,2164,2166],{},[127,2162,2163],{},"Match Triangle Meshes option",[127,2165,1640],{},[127,2167,1604],{},[112,2169,2170,2172,2174],{},[127,2171,761],{},[127,2173,1640],{},[127,2175,1604],{},[112,2177,2178,2180,2182],{},[127,2179,785],{},[127,2181,1640],{},[127,2183,1604],{},[17,2185,2186,2187,2189,2190,2193],{},"Both versions support Blender 4.2 and newer. To see the tools in action first, try the ",[86,2188,1675],{"href":796}," with Lite for the three shared tools, or read the ",[86,2191,2192],{"href":949},"product page"," for the full list.",[12,2195,1126],{"id":1125},[33,2197,2198,2202,2206],{},[36,2199,1131,2200],{},[86,2201,747],{"href":949},[36,2203,2204],{},[86,2205,370],{"href":835},[36,2207,1461,2208,305,2210,612,2212],{},[86,2209,1464],{"href":858},[86,2211,1467],{"href":865},[86,2213,1470],{"href":872},{"title":386,"searchDepth":387,"depth":387,"links":2215},[2216,2217,2218,2219,2220,2221,2222],{"id":283,"depth":387,"text":284},{"id":2001,"depth":387,"text":2002},{"id":1524,"depth":387,"text":1525},{"id":1553,"depth":387,"text":1554},{"id":1563,"depth":387,"text":1564},{"id":2089,"depth":387,"text":2090},{"id":1125,"depth":387,"text":1126},"Install QuadFix from its .zip in Blender 4.2 or newer, find the QuadFix sidebar tab, update or remove it, and compare QuadFix Lite with the full version.",{},"---\ntitle: \"Install QuadFix in Blender\"\ndescription: \"Install QuadFix from its .zip in Blender 4.2 or newer, find the QuadFix sidebar tab, update or remove it, and compare QuadFix Lite with the full version.\"\naddon: quadfix\norder: 2\nupdated: 2026-11-16\n---\n\n## Requirements\n\nQuadFix is a Blender extension and needs Blender 4.2 or newer. It uses only Blender's own Python and `bmesh`, so there is nothing else to install and no internet connection is needed.\n\n## Install from the .zip\n\nDownload the .zip from [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix) or [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fquadfix?utm_source=mendboxstudio&utm_medium=docs&utm_campaign=quadfix). Do not unzip it.\n\n1. In Blender open **Edit > Preferences > Get Extensions**.\n2. Click the small arrow menu at the top right of the window and choose **Install from Disk**.\n3. Pick the .zip file.\n4. Make sure the add-on is enabled in the list.\n\nInstead of steps 1 to 3 you can drag the .zip file into the Blender window and confirm the install.\n\n## Where the panel appears\n\n1. Select a mesh object in the 3D viewport.\n2. Press `N` to open the sidebar.\n3. Open the tab named **QuadFix**.\n\nThe tab is available in Object Mode and in Edit Mode. The mesh tools need Edit Mode and appear greyed out in Object Mode, with a note to press `Tab`. The union tool needs Object Mode and is greyed out in Edit Mode. At the bottom of the tab a footer panel shows the installed version, for example `QuadFix v1.4.5`, and the result of the last operation.\n\nEverything is described in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Update\n\nOpen **Edit > Preferences > Get Extensions**, use **Install from Disk** with the new .zip and confirm that it replaces the old version. Updates for the 1.x line are free. The [changelog](\u002Fdocs\u002Fquadfix\u002Fchangelog) lists what each version changed.\n\n## Uninstall\n\nOpen **Edit > Preferences > Get Extensions**, find QuadFix in the list of installed extensions and remove it. Your meshes are not changed by removing the add-on.\n\n## Lite or full\n\nThe free [QuadFix Lite](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fquadfix-lite) is a separate extension. Its sidebar tab is named **QuadFix Lite**. Download its .zip from the Releases page on GitHub and install it the same way.\n\n| Tool | Lite (free) | Full ($12) |\n|---|---|---|\n| Select Non-Quads & Holes | yes | yes |\n| N-gons to Quads | yes | yes |\n| Clean & Quad | yes | yes |\n| Only Selected, last-result report, undo | yes | yes |\n| Fill Holes with Quads | no | yes |\n| Match Triangle Meshes option | no | yes |\n| Bridge to Quads | no | yes |\n| Union to Quads | no | yes |\n\nBoth versions support Blender 4.2 and newer. To see the tools in action first, try the [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows) with Lite for the three shared tools, or read the [product page](\u002Faddons\u002Fquadfix) for the full list.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":1987,"description":2223},"docs\u002Fquadfix\u002Finstall","WZjJS8gh-7dp-bvT-cnw-6NOH1LBg-EJ2YkhCGAqfKI",{"id":2230,"title":2231,"addon":962,"body":2232,"description":2937,"extension":403,"meta":2938,"navigation":408,"order":1152,"path":88,"rawbody":2939,"seo":2940,"stem":2941,"updated":417,"__hash__":2942},"docs\u002Fdocs\u002Fbedsplit\u002Fpanel.md","BedSplit panel reference",{"type":9,"value":2233,"toc":2924},[2234,2238,2253,2257,2321,2324,2326,2479,2485,2489,2536,2539,2543,2598,2601,2618,2621,2643,2647,2705,2708,2722,2725,2731,2748,2751,2754,2758,2761,2814,2817,2897,2900,2903,2908,2910],[12,2235,2237],{"id":2236},"where-everything-is","Where everything is",[17,2239,2240,2241,2243,2244,2246,2247,2249,2250,2252],{},"All controls live in the ",[28,2242,407],{}," tab of the 3D Viewport sidebar (press ",[28,2245,1378],{},"), in Object Mode. The tab has two panels: ",[28,2248,407],{}," (settings and the split button) and ",[28,2251,1011],{}," (what the last split produced and the export button). If no mesh is selected the top of the panel says \"Select a mesh object\".",[12,2254,2256],{"id":2255},"printer","Printer",[106,2258,2259,2271],{},[109,2260,2261],{},[112,2262,2263,2266,2268],{},[115,2264,2265],{},"Control",[115,2267,447],{},[115,2269,2270],{},"Default and range",[122,2272,2273,2284,2299,2311],{},[112,2274,2275,2278,2281],{},[127,2276,2277],{},"Printer (dropdown)",[127,2279,2280],{},"Chooses the build volume. Each entry shows its name and width × depth × height in millimetres.",[127,2282,2283],{},"Creality Ender 3 \u002F V3 SE (220 × 220 × 250)",[112,2285,2286,2289,2296],{},[127,2287,2288],{},"Custom size",[127,2290,2291,2292,2295],{},"Last entry of the dropdown. Shows the ",[28,2293,2294],{},"Bed"," fields so you can type your own size.",[127,2297,2298],{},"Off",[112,2300,2301,2303,2308],{},[127,2302,2294],{},[127,2304,2305,2306,90],{},"Width, depth and print height in millimetres. Visible only with ",[28,2307,2288],{},[127,2309,2310],{},"220, 220, 250. Minimum 40 each",[112,2312,2313,2316,2319],{},[127,2314,2315],{},"Bed: ... mm",[127,2317,2318],{},"Read-only line that repeats the size in use.",[127,2320],{},[17,2322,2323],{},"Changing the printer or the bed size clears the cut list, so the cuts are found again for the new bed.",[1068,2325,101],{"id":100},[106,2327,2328,2337],{},[109,2329,2330],{},[112,2331,2332,2334],{},[115,2333,2256],{},[115,2335,2336],{},"Width × depth × height, mm",[122,2338,2339,2347,2355,2363,2370,2378,2386,2394,2402,2409,2417,2425,2432,2440,2448,2456,2463,2471],{},[112,2340,2341,2344],{},[127,2342,2343],{},"Bambu Lab A1 mini",[127,2345,2346],{},"180 × 180 × 180",[112,2348,2349,2352],{},[127,2350,2351],{},"Bambu Lab A1 \u002F P1 \u002F X1",[127,2353,2354],{},"256 × 256 × 256",[112,2356,2357,2360],{},[127,2358,2359],{},"Bambu Lab H2D",[127,2361,2362],{},"350 × 320 × 325",[112,2364,2365,2368],{},[127,2366,2367],{},"Prusa MINI+",[127,2369,2346],{},[112,2371,2372,2375],{},[127,2373,2374],{},"Prusa MK4 \u002F MK3",[127,2376,2377],{},"250 × 210 × 220",[112,2379,2380,2383],{},[127,2381,2382],{},"Prusa XL",[127,2384,2385],{},"360 × 360 × 360",[112,2387,2388,2391],{},[127,2389,2390],{},"Prusa CORE One",[127,2392,2393],{},"250 × 220 × 270",[112,2395,2396,2399],{},[127,2397,2398],{},"Creality Ender 3 \u002F V3 SE",[127,2400,2401],{},"220 × 220 × 250",[112,2403,2404,2407],{},[127,2405,2406],{},"Creality K1",[127,2408,2401],{},[112,2410,2411,2414],{},[127,2412,2413],{},"Creality K1 Max",[127,2415,2416],{},"300 × 300 × 300",[112,2418,2419,2422],{},[127,2420,2421],{},"Creality Ender 5 Plus",[127,2423,2424],{},"350 × 350 × 400",[112,2426,2427,2430],{},[127,2428,2429],{},"Anycubic Kobra 2",[127,2431,2401],{},[112,2433,2434,2437],{},[127,2435,2436],{},"Anycubic Kobra 3",[127,2438,2439],{},"250 × 250 × 260",[112,2441,2442,2445],{},[127,2443,2444],{},"Elegoo Neptune 4",[127,2446,2447],{},"225 × 225 × 265",[112,2449,2450,2453],{},[127,2451,2452],{},"Elegoo Neptune 4 Max",[127,2454,2455],{},"420 × 420 × 480",[112,2457,2458,2461],{},[127,2459,2460],{},"Sovol SV06",[127,2462,2401],{},[112,2464,2465,2468],{},[127,2466,2467],{},"Voron 2.4 300",[127,2469,2470],{},"300 × 300 × 280",[112,2472,2473,2476],{},[127,2474,2475],{},"Voron 0.2",[127,2477,2478],{},"120 × 120 × 120",[17,2480,2481,2482,2484],{},"The presets are the nominal build volumes. If your machine has a smaller usable area, choose ",[28,2483,2288],{}," and type a smaller bed.",[12,2486,2488],{"id":2487},"model-size","Model size",[106,2490,2491,2501],{},[109,2492,2493],{},[112,2494,2495,2497,2499],{},[115,2496,2265],{},[115,2498,447],{},[115,2500,2270],{},[122,2502,2503,2513,2522],{},[112,2504,2505,2508,2511],{},[127,2506,2507],{},"Now: ... mm longest side",[127,2509,2510],{},"Read-only. The longest side of the selected object, taken from its dimensions and the scene unit scale.",[127,2512],{},[112,2514,2515,2517,2520],{},[127,2516,190],{},[127,2518,2519],{},"Off: the model is printed at its current size (scene unit scale applied). On: the parts are scaled so the longest side of the whole model has the size below.",[127,2521,2298],{},[112,2523,2524,2527,2533],{},[127,2525,2526],{},"Longest side, mm",[127,2528,2529,2530,2532],{},"Printed size of the longest side of the whole model. Greyed out unless ",[28,2531,190],{}," is on.",[127,2534,2535],{},"400. Minimum 10",[17,2537,2538],{},"Changing either control clears the cut list.",[12,2540,2542],{"id":2541},"cuts","Cuts",[106,2544,2545,2555],{},[109,2546,2547],{},[112,2548,2549,2551,2553],{},[115,2550,2265],{},[115,2552,447],{},[115,2554,2270],{},[122,2556,2557,2566,2577,2588],{},[112,2558,2559,2561,2564],{},[127,2560,50],{},[127,2562,2563],{},"Places the cut planes automatically for the chosen printer and draws them in the viewport. Reports how many cuts were found, or that the model fits the bed and no cut is needed.",[127,2565],{},[112,2567,2568,2571,2574],{},[127,2569,2570],{},"Show cuts in viewport",[127,2572,2573],{},"Shows or hides the planes in the viewport. Appears once a cut list exists.",[127,2575,2576],{},"On",[112,2578,2579,2582,2585],{},[127,2580,2581],{},"Cut row: axis, position, X",[127,2583,2584],{},"One row per plane. The label is X, Y or Z. The number is the distance in millimetres from the start of the model along that axis. The X button removes the plane.",[127,2586,2587],{},"Position 0 or more",[112,2589,2590,2593,2596],{},[127,2591,2592],{},"Add cut: X Y Z",[127,2594,2595],{},"Adds a plane across that axis in the middle of the largest remaining piece.",[127,2597],{},[17,2599,2600],{},"Status lines in this box:",[33,2602,2603,2612],{},[36,2604,2605,2608,2609,2611],{},[28,2606,2607],{},"Automatic",": no cut list yet. ",[28,2610,30],{}," will find the cuts itself.",[36,2613,2614,2617],{},[28,2615,2616],{},"No cuts: model fits the bed",": the automatic search found nothing to cut.",[17,2619,2620],{},"Rules worth knowing:",[33,2622,2623,2626,2631,2637],{},[36,2624,2625],{},"Planes closer than 0.5 mm to an end of the model, or within 0.5 mm of another plane on the same axis, are ignored.",[36,2627,2628,2629,90],{},"The list belongs to one object at one position and size. If you move, rotate or scale the object, or change the size settings, the list is dropped and the panel returns to ",[28,2630,2607],{},[36,2632,2633,2634,2636],{},"When a cut list exists, ",[28,2635,30],{}," uses exactly that list. Moving a plane while it is hidden shows it again.",[36,2638,2639,2640,2642],{},"A manual cut list is not checked against the bed. The ",[28,2641,1011],{}," panel tells you afterwards if a part is still too big.",[12,2644,2646],{"id":2645},"dowels","Dowels",[106,2648,2649,2659],{},[109,2650,2651],{},[112,2652,2653,2655,2657],{},[115,2654,2265],{},[115,2656,447],{},[115,2658,2270],{},[122,2660,2661,2672,2683,2694],{},[112,2662,2663,2666,2669],{},[127,2664,2665],{},"Dowel diameter, mm",[127,2667,2668],{},"Diameter of the dowel.",[127,2670,2671],{},"6.0, range 2 to 20",[112,2673,2674,2677,2680],{},[127,2675,2676],{},"Depth in each part, mm",[127,2678,2679],{},"How far the dowel goes into each part. The dowel is twice this long.",[127,2681,2682],{},"6.0, range 2 to 30",[112,2684,2685,2688,2691],{},[127,2686,2687],{},"Clearance, mm",[127,2689,2690],{},"Gap between dowel and socket. 0.2 suits most printers. Raise it when the dowels do not go in.",[127,2692,2693],{},"0.2, range 0 to 1",[112,2695,2696,2699,2702],{},[127,2697,2698],{},"Dowels per joint",[127,2700,2701],{},"The largest number of dowels placed on one cut face.",[127,2703,2704],{},"2, range 1 to 3",[17,2706,2707],{},"How the sockets are placed:",[33,2709,2710,2713,2716,2719],{},[36,2711,2712],{},"The socket is as wide as the dowel plus the clearance on every side, and as deep as the depth plus the clearance.",[36,2714,2715],{},"At least 1.6 mm of material must remain around a socket in both parts. With the default dowel that means a section roughly 10 mm across; thinner walls get no dowel.",[36,2717,2718],{},"Dowels on the same joint are kept at least three dowel diameters apart.",[36,2720,2721],{},"Every separate patch of a cut face is treated on its own, so a joint with two limbs can get dowels in both.",[12,2723,30],{"id":2724},"split-to-bed",[17,2726,2727,2728,2730],{},"The large button at the bottom of the ",[28,2729,407],{}," panel. It:",[980,2732,2733,2736,2739,2742,2745],{},[36,2734,2735],{},"Reads the mesh (including modifiers) in world axes, scaled to millimetres.",[36,2737,2738],{},"Repairs it if needed.",[36,2740,2741],{},"Cuts it along the cut list, or along automatically chosen planes.",[36,2743,2744],{},"Adds sockets and checks every part.",[36,2746,2747],{},"Turns each part so its largest cut face lies on the ground that still fits the bed, and places the parts in a square grid beside the model with a 15 mm gap.",[17,2749,2750],{},"The result is a collection named \"BedSplit - \" followed by the source name. Parts are named like \"Knight part 01\" and each has its own colour, repeated after eight. All dowels are one extra object named like \"Knight dowel x6\", where the number is how many to print. The original model is unchanged and stays active. The parts are selected. The cuts are hidden after the split. A new split of the same source replaces the previous collection. Undo removes the split.",[17,2752,2753],{},"The button is available only in Object Mode with a mesh. If the model already fits the bed and there are no cuts, you get \"the model fits the bed, nothing to split. Add a cut to split it anyway\".",[12,2755,2757],{"id":2756},"result-panel","Result panel",[17,2759,2760],{},"The title shows the add-on version. Before any split it says \"No result yet\". After a split it shows:",[106,2762,2763,2773],{},[109,2764,2765],{},[112,2766,2767,2770],{},[115,2768,2769],{},"Line",[115,2771,2772],{},"Meaning",[122,2774,2775,2783,2791,2799,2807],{},[112,2776,2777,2780],{},[127,2778,2779],{},"N parts, M dowels",[127,2781,2782],{},"Count of parts and of dowels to print. A check mark means the parts are closed and fit the bed.",[112,2784,2785,2788],{},[127,2786,2787],{},"Source name and seconds",[127,2789,2790],{},"Which object was split and how long it took.",[112,2792,2793,2796],{},[127,2794,2795],{},"Messages",[127,2797,2798],{},"What was repaired and what needs attention (see below).",[112,2800,2801,2804],{},[127,2802,2803],{},"Part n: W × D × H mm",[127,2805,2806],{},"One row per part, with a check mark when it fits the bed and is closed.",[112,2808,2809,2811],{},[127,2810,290],{},[127,2812,2813],{},"Opens a folder chooser.",[17,2815,2816],{},"Possible messages:",[106,2818,2819,2828],{},[109,2820,2821],{},[112,2822,2823,2826],{},[115,2824,2825],{},"Message",[115,2827,2772],{},[122,2829,2830,2838,2846,2854,2862,2872,2881,2889],{},[112,2831,2832,2835],{},[127,2833,2834],{},"Repaired: holes closed, normals fixed",[127,2836,2837],{},"Light repair was enough.",[112,2839,2840,2843],{},[127,2841,2842],{},"Repaired: overlapping shells joined",[127,2844,2845],{},"Several overlapping shells were merged into one solid.",[112,2847,2848,2851],{},[127,2849,2850],{},"Repaired: surface rebuilt (within x mm)",[127,2852,2853],{},"The surface was rebuilt. The detail stayed within x mm.",[112,2855,2856,2859],{},[127,2857,2858],{},"Heavy repair: surface rebuilt, fine detail smoothed (x mm)",[127,2860,2861],{},"The rebuild moved the surface by more than 0.5 mm for 99 percent of it. Check the result.",[112,2863,2864,2867],{},[127,2865,2866],{},"N part(s) not watertight: move a cut plane and split again",[127,2868,2869,2870,90],{},"See ",[86,2871,629],{"href":369},[112,2873,2874,2877],{},[127,2875,2876],{},"N part(s) larger than the bed: add a cut plane",[127,2878,2869,2879,90],{},[86,2880,629],{"href":369},[112,2882,2883,2886],{},[127,2884,2885],{},"N joint(s) without dowel (wall too thin): glue these",[127,2887,2888],{},"Those joints are flat cuts only.",[112,2890,2891,2894],{},[127,2892,2893],{},"A dowel socket came out wrong: check the joints",[127,2895,2896],{},"Inspect the sockets before printing.",[12,2898,290],{"id":2899},"export-stl",[17,2901,2902],{},"Saves every part of the last split as a binary STL in millimetres, plus one dowel file. File names come from the object names, with spaces and unusual characters replaced by underscores, so the dowel file keeps its count, for example \"Knight_dowel_x6.stl\". The button needs a result in the scene. If you cancel the folder chooser or leave it empty you get \"choose a folder\". The folder is created if it does not exist.",[17,2904,2905,2906,90],{},"For use of these controls in order, see the ",[86,2907,1675],{"href":363},[12,2909,1126],{"id":1125},[33,2911,2912,2916,2920],{},[36,2913,1131,2914],{},[86,2915,407],{"href":409},[36,2917,2918],{},[86,2919,370],{"href":369},[36,2921,379,2922],{},[86,2923,383],{"href":382},{"title":386,"searchDepth":387,"depth":387,"links":2925},[2926,2927,2930,2931,2932,2933,2934,2935,2936],{"id":2236,"depth":387,"text":2237},{"id":2255,"depth":387,"text":2256,"children":2928},[2929],{"id":100,"depth":1152,"text":101},{"id":2487,"depth":387,"text":2488},{"id":2541,"depth":387,"text":2542},{"id":2645,"depth":387,"text":2646},{"id":2724,"depth":387,"text":30},{"id":2756,"depth":387,"text":2757},{"id":2899,"depth":387,"text":290},{"id":1125,"depth":387,"text":1126},"Every BedSplit control with its default and range: printer presets, Resize for print, cut planes, dowels, Split to Bed, the Result panel and STL export.",{},"---\ntitle: \"BedSplit panel reference\"\ndescription: \"Every BedSplit control with its default and range: printer presets, Resize for print, cut planes, dowels, Split to Bed, the Result panel and STL export.\"\naddon: bedsplit\norder: 3\nupdated: 2026-11-16\n---\n\n## Where everything is\n\nAll controls live in the **BedSplit** tab of the 3D Viewport sidebar (press **N**), in Object Mode. The tab has two panels: **BedSplit** (settings and the split button) and **Result** (what the last split produced and the export button). If no mesh is selected the top of the panel says \"Select a mesh object\".\n\n## Printer\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Printer (dropdown) | Chooses the build volume. Each entry shows its name and width × depth × height in millimetres. | Creality Ender 3 \u002F V3 SE (220 × 220 × 250) |\n| Custom size | Last entry of the dropdown. Shows the **Bed** fields so you can type your own size. | Off |\n| Bed | Width, depth and print height in millimetres. Visible only with **Custom size**. | 220, 220, 250. Minimum 40 each |\n| Bed: ... mm | Read-only line that repeats the size in use. | |\n\nChanging the printer or the bed size clears the cut list, so the cuts are found again for the new bed.\n\n### Printer presets\n\n| Printer | Width × depth × height, mm |\n|---|---|\n| Bambu Lab A1 mini | 180 × 180 × 180 |\n| Bambu Lab A1 \u002F P1 \u002F X1 | 256 × 256 × 256 |\n| Bambu Lab H2D | 350 × 320 × 325 |\n| Prusa MINI+ | 180 × 180 × 180 |\n| Prusa MK4 \u002F MK3 | 250 × 210 × 220 |\n| Prusa XL | 360 × 360 × 360 |\n| Prusa CORE One | 250 × 220 × 270 |\n| Creality Ender 3 \u002F V3 SE | 220 × 220 × 250 |\n| Creality K1 | 220 × 220 × 250 |\n| Creality K1 Max | 300 × 300 × 300 |\n| Creality Ender 5 Plus | 350 × 350 × 400 |\n| Anycubic Kobra 2 | 220 × 220 × 250 |\n| Anycubic Kobra 3 | 250 × 250 × 260 |\n| Elegoo Neptune 4 | 225 × 225 × 265 |\n| Elegoo Neptune 4 Max | 420 × 420 × 480 |\n| Sovol SV06 | 220 × 220 × 250 |\n| Voron 2.4 300 | 300 × 300 × 280 |\n| Voron 0.2 | 120 × 120 × 120 |\n\nThe presets are the nominal build volumes. If your machine has a smaller usable area, choose **Custom size** and type a smaller bed.\n\n## Model size\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Now: ... mm longest side | Read-only. The longest side of the selected object, taken from its dimensions and the scene unit scale. | |\n| Resize for print | Off: the model is printed at its current size (scene unit scale applied). On: the parts are scaled so the longest side of the whole model has the size below. | Off |\n| Longest side, mm | Printed size of the longest side of the whole model. Greyed out unless **Resize for print** is on. | 400. Minimum 10 |\n\nChanging either control clears the cut list.\n\n## Cuts\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Find Cuts | Places the cut planes automatically for the chosen printer and draws them in the viewport. Reports how many cuts were found, or that the model fits the bed and no cut is needed. | |\n| Show cuts in viewport | Shows or hides the planes in the viewport. Appears once a cut list exists. | On |\n| Cut row: axis, position, X | One row per plane. The label is X, Y or Z. The number is the distance in millimetres from the start of the model along that axis. The X button removes the plane. | Position 0 or more |\n| Add cut: X Y Z | Adds a plane across that axis in the middle of the largest remaining piece. | |\n\nStatus lines in this box:\n\n- **Automatic**: no cut list yet. **Split to Bed** will find the cuts itself.\n- **No cuts: model fits the bed**: the automatic search found nothing to cut.\n\nRules worth knowing:\n\n- Planes closer than 0.5 mm to an end of the model, or within 0.5 mm of another plane on the same axis, are ignored.\n- The list belongs to one object at one position and size. If you move, rotate or scale the object, or change the size settings, the list is dropped and the panel returns to **Automatic**.\n- When a cut list exists, **Split to Bed** uses exactly that list. Moving a plane while it is hidden shows it again.\n- A manual cut list is not checked against the bed. The **Result** panel tells you afterwards if a part is still too big.\n\n## Dowels\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Dowel diameter, mm | Diameter of the dowel. | 6.0, range 2 to 20 |\n| Depth in each part, mm | How far the dowel goes into each part. The dowel is twice this long. | 6.0, range 2 to 30 |\n| Clearance, mm | Gap between dowel and socket. 0.2 suits most printers. Raise it when the dowels do not go in. | 0.2, range 0 to 1 |\n| Dowels per joint | The largest number of dowels placed on one cut face. | 2, range 1 to 3 |\n\nHow the sockets are placed:\n\n- The socket is as wide as the dowel plus the clearance on every side, and as deep as the depth plus the clearance.\n- At least 1.6 mm of material must remain around a socket in both parts. With the default dowel that means a section roughly 10 mm across; thinner walls get no dowel.\n- Dowels on the same joint are kept at least three dowel diameters apart.\n- Every separate patch of a cut face is treated on its own, so a joint with two limbs can get dowels in both.\n\n## Split to Bed\n\nThe large button at the bottom of the **BedSplit** panel. It:\n\n1. Reads the mesh (including modifiers) in world axes, scaled to millimetres.\n2. Repairs it if needed.\n3. Cuts it along the cut list, or along automatically chosen planes.\n4. Adds sockets and checks every part.\n5. Turns each part so its largest cut face lies on the ground that still fits the bed, and places the parts in a square grid beside the model with a 15 mm gap.\n\nThe result is a collection named \"BedSplit - \" followed by the source name. Parts are named like \"Knight part 01\" and each has its own colour, repeated after eight. All dowels are one extra object named like \"Knight dowel x6\", where the number is how many to print. The original model is unchanged and stays active. The parts are selected. The cuts are hidden after the split. A new split of the same source replaces the previous collection. Undo removes the split.\n\nThe button is available only in Object Mode with a mesh. If the model already fits the bed and there are no cuts, you get \"the model fits the bed, nothing to split. Add a cut to split it anyway\".\n\n## Result panel\n\nThe title shows the add-on version. Before any split it says \"No result yet\". After a split it shows:\n\n| Line | Meaning |\n|---|---|\n| N parts, M dowels | Count of parts and of dowels to print. A check mark means the parts are closed and fit the bed. |\n| Source name and seconds | Which object was split and how long it took. |\n| Messages | What was repaired and what needs attention (see below). |\n| Part n: W × D × H mm | One row per part, with a check mark when it fits the bed and is closed. |\n| Export STL | Opens a folder chooser. |\n\nPossible messages:\n\n| Message | Meaning |\n|---|---|\n| Repaired: holes closed, normals fixed | Light repair was enough. |\n| Repaired: overlapping shells joined | Several overlapping shells were merged into one solid. |\n| Repaired: surface rebuilt (within x mm) | The surface was rebuilt. The detail stayed within x mm. |\n| Heavy repair: surface rebuilt, fine detail smoothed (x mm) | The rebuild moved the surface by more than 0.5 mm for 99 percent of it. Check the result. |\n| N part(s) not watertight: move a cut plane and split again | See [troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting). |\n| N part(s) larger than the bed: add a cut plane | See [troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting). |\n| N joint(s) without dowel (wall too thin): glue these | Those joints are flat cuts only. |\n| A dowel socket came out wrong: check the joints | Inspect the sockets before printing. |\n\n## Export STL\n\nSaves every part of the last split as a binary STL in millimetres, plus one dowel file. File names come from the object names, with spaces and unusual characters replaced by underscores, so the dowel file keeps its count, for example \"Knight_dowel_x6.stl\". The button needs a result in the scene. If you cancel the folder chooser or leave it empty you get \"choose a folder\". The folder is created if it does not exist.\n\nFor use of these controls in order, see the [workflows](\u002Fdocs\u002Fbedsplit\u002Fworkflows).\n\n## Related\n\n- Product page: [BedSplit](\u002Faddons\u002Fbedsplit)\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting)\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing)\n",{"title":2231,"description":2937},"docs\u002Fbedsplit\u002Fpanel","9LR1YfdGfQtcVv74et-6DYMMIs4tZpKUNwbp2xOr_5w",{"id":2944,"title":2945,"addon":1164,"body":2946,"description":3523,"extension":403,"meta":3524,"navigation":408,"order":1152,"path":551,"rawbody":3525,"seo":3526,"stem":3527,"updated":417,"__hash__":3528},"docs\u002Fdocs\u002Fimage-per-instance\u002Fpanel.md","Image Per Instance panel reference",{"type":9,"value":2947,"toc":3513},[2948,2957,2961,3079,3083,3146,3155,3158,3161,3229,3232,3235,3316,3319,3322,3357,3360,3363,3428,3432,3489,3497,3499],[17,2949,2950,2951,2953,2954,2956],{},"All controls live in the 3D viewport sidebar (",[28,2952,1378],{},"), in the ",[28,2955,715],{}," tab. This page follows the panel from top to bottom. Version 0.2.0.",[12,2958,2960],{"id":2959},"main-panel-atlas-settings","Main panel: atlas settings",[106,2962,2963,2974],{},[109,2964,2965],{},[112,2966,2967,2969,2971],{},[115,2968,2265],{},[115,2970,447],{},[115,2972,2973],{},"Default \u002F range",[122,2975,2976,2986,2996,3007,3029,3042,3053,3067],{},[112,2977,2978,2980,2983],{},[127,2979,1254],{},[127,2981,2982],{},"Folder with your images. Only files directly inside it are read, not subfolders. Supported types: png, jpg, jpeg, tif, tiff, bmp, webp, exr, tga.",[127,2984,2985],{},"empty",[112,2987,2988,2990,2993],{},[127,2989,1258],{},[127,2991,2992],{},"Size of one atlas tile in pixels: 128, 256, 512, 1024 or 2048. With a non-square Tile Shape this is the length of the longer side.",[127,2994,2995],{},"512 px",[112,2997,2998,3001,3004],{},[127,2999,3000],{},"Tile Shape",[127,3002,3003],{},"Shape of one tile: 1 : 1, 2 : 3, 3 : 2, 3 : 4, 4 : 3, 16 : 9 or 9 : 16. Pick the shape of your frames, covers or screens.",[127,3005,3006],{},"1 : 1",[112,3008,3009,3012,3027],{},[127,3010,3011],{},"Fit",[127,3013,3014,3015,3018,3019,3022,3023,3026],{},"What happens when an image has a different shape than the tile. ",[28,3016,3017],{},"Stretch"," fills the tile and distorts the image. ",[28,3020,3021],{},"Fit (bars)"," shows the whole image with bars around it. ",[28,3024,3025],{},"Fill (crop)"," covers the whole tile and crops the edges.",[127,3028,3017],{},[112,3030,3031,3034,3039],{},[127,3032,3033],{},"Bar Colour",[127,3035,3036,3037,90],{},"Colour of the bars. Only shown when Fit is ",[28,3038,3021],{},[127,3040,3041],{},"black, 0 to 1 per channel",[112,3043,3044,3047,3050],{},[127,3045,3046],{},"Padding",[127,3048,3049],{},"Edge padding in pixels that hides bleeding between neighbouring tiles.",[127,3051,3052],{},"4, range 0 to 32",[112,3054,3055,3057,3065],{},[127,3056,484],{},[127,3058,3059,674,3062,3064],{},[28,3060,3061],{},"By file name",[28,3063,1885],{},". Shuffle uses every image once before any repeats. It changes which image an object or instance gets, not the order inside the atlas.",[127,3066,3061],{},[112,3068,3069,3071,3076],{},[127,3070,488],{},[127,3072,3073,3074,90],{},"Picks the shuffled arrangement. Only shown when Order is ",[28,3075,1885],{},[127,3077,3078],{},"1",[12,3080,3082],{"id":3081},"main-panel-buttons-and-labels","Main panel: buttons and labels",[106,3084,3085,3093],{},[109,3086,3087],{},[112,3088,3089,3091],{},[115,3090,2265],{},[115,3092,447],{},[122,3094,3095,3102,3110,3123,3130,3138],{},[112,3096,3097,3099],{},[127,3098,436],{},[127,3100,3101],{},"Packs all images from the folder into one atlas and creates the shared material. The atlas is always in natural file-name order, so Image Number N is the N-th file. Pressing it again replaces the atlas. Objects keep the picture they showed, matched by file name.",[112,3103,3104,3107],{},[127,3105,3106],{},"Atlas label",[127,3108,3109],{},"Shows \"Atlas: N images\", or \"Atlas: not built\" before the first build.",[112,3111,3112,3114],{},[127,3113,468],{},[127,3115,3116,3117,3119,3120,3122],{},"Gives each selected mesh object its own image and puts the shared material on it. With Order ",[28,3118,3061],{},", objects are sorted by name (natural order) and get images 1, 2, 3 and so on, wrapping around when there are more objects than images. With ",[28,3121,1885],{},", the objects are shuffled using the Seed.",[112,3124,3125,3127],{},[127,3126,474],{},[127,3128,3129],{},"The active object is the host with your Array or Instance on Points modifier. The add-on finds the instanced source objects, sets the shared material on them, and adds a modifier named \"IPI Assign Index\" on the host. Selected mesh objects are added as sources too. Press it again after changing Seed or Order to update the modifier.",[112,3131,3132,3135],{},[127,3133,3134],{},"\"Press again after changing Seed to re-shuffle\"",[127,3136,3137],{},"A hint. Change Seed, then press Apply To Selected Objects or Add To Instances again.",[112,3139,3140,3143],{},[127,3141,3142],{},"Version label",[127,3144,3145],{},"\"Image Per Instance v\" followed by the version number.",[17,3147,3148,3149,3151,3152,3154],{},"How the atlas is laid out: the number of columns is chosen from the image count and the tile shape, so the atlas stays roughly square. The atlas image is named ",[456,3150,1797],{},", the material ",[456,3153,1793],{},". The atlas can be at most 16384 px on each side.",[12,3156,1760],{"id":3157},"choose-images-yourself",[17,3159,3160],{},"Collapsed by default. Applies to separate objects only, as the panel says.",[106,3162,3163,3173],{},[109,3164,3165],{},[112,3166,3167,3169,3171],{},[115,3168,2265],{},[115,3170,447],{},[115,3172,2973],{},[122,3174,3175,3186,3196,3205],{},[112,3176,3177,3180,3183],{},[127,3178,3179],{},"Image Number",[127,3181,3182],{},"Number of the image in the atlas. 1 is the first file. Changing it updates the Image field.",[127,3184,3185],{},"1, minimum 1",[112,3187,3188,3191,3194],{},[127,3189,3190],{},"Image (search field)",[127,3192,3193],{},"Pick the image by file name, you can type to search. Choosing a name sets Image Number.",[127,3195,2985],{},[112,3197,3198,3200,3203],{},[127,3199,611],{},[127,3201,3202],{},"Gives every selected mesh object the image with the chosen number, and the shared material. Fails with a message if the number is higher than the number of images.",[127,3204],{},[112,3206,3207,3209,3227],{},[127,3208,513],{},[127,3210,3211,3212,3215,3216,3219,3220,3222,3223,3226],{},"Each selected object gets the image whose file name equals the object name. If there is no exact match, the longest file name that appears as a whole word in the object name wins (",[456,3213,3214],{},"card_10"," gets ",[456,3217,3218],{},"10",", not ",[456,3221,3078],{},"), then the longest file name contained in the name. A Blender duplicate suffix such as ",[456,3224,3225],{},".001"," is ignored, and case does not matter. Objects without a match are listed in the message.",[127,3228],{},[12,3230,1763],{"id":3231},"material",[17,3233,3234],{},"Collapsed by default. These options update the material at once, without pressing a button again, as long as the atlas is built.",[106,3236,3237,3247],{},[109,3238,3239],{},[112,3240,3241,3243,3245],{},[115,3242,2265],{},[115,3244,447],{},[115,3246,2973],{},[122,3248,3249,3273,3284,3294,3305],{},[112,3250,3251,3254,3271],{},[127,3252,3253],{},"Mapping",[127,3255,3256,3257,3260,3261,305,3264,612,3267,3270],{},"Where the image sits on the object. ",[28,3258,3259],{},"UV Map"," uses the object's UV map, which must fill the 0 to 1 square. ",[28,3262,3263],{},"Front (no UVs)",[28,3265,3266],{},"Top (no UVs)",[28,3268,3269],{},"Side (no UVs)"," project the image across the whole object from the front, top or right side.",[127,3272,3259],{},[112,3274,3275,3278,3281],{},[127,3276,3277],{},"Use Image Alpha",[127,3279,3280],{},"PNG transparency cuts the shape out (stickers, round cards, the bars of Fit mode). Sets the material render method to Dithered.",[127,3282,3283],{},"off",[112,3285,3286,3289,3292],{},[127,3287,3288],{},"Emissive (screen)",[127,3290,3291],{},"The image glows by itself, for video walls, billboards and screens.",[127,3293,3283],{},[112,3295,3296,3299,3302],{},[127,3297,3298],{},"Strength",[127,3300,3301],{},"Emission strength. Only shown when Emissive is on.",[127,3303,3304],{},"1.0, minimum 0, soft maximum 10",[112,3306,3307,3310,3313],{},[127,3308,3309],{},"Roughness",[127,3311,3312],{},"Roughness of the material.",[127,3314,3315],{},"0.5, range 0 to 1",[12,3317,1766],{"id":3318},"animate",[17,3320,3321],{},"Collapsed by default. The checkbox in the sub-panel header switches animation on.",[106,3323,3324,3334],{},[109,3325,3326],{},[112,3327,3328,3330,3332],{},[115,3329,2265],{},[115,3331,447],{},[115,3333,2973],{},[122,3335,3336,3346],{},[112,3337,3338,3341,3344],{},[127,3339,3340],{},"Animate (checkbox)",[127,3342,3343],{},"Every object steps through the images over time, each starting at its own image.",[127,3345,3283],{},[112,3347,3348,3351,3354],{},[127,3349,3350],{},"Frames Per Image",[127,3352,3353],{},"How many frames each image stays before the next one.",[127,3355,3356],{},"24, minimum 1, soft maximum 240",[12,3358,1769],{"id":3359},"random-variation",[17,3361,3362],{},"Collapsed by default. All values start at zero, which adds no nodes to the material.",[106,3364,3365,3375],{},[109,3366,3367],{},[112,3368,3369,3371,3373],{},[115,3370,2265],{},[115,3372,447],{},[115,3374,2973],{},[122,3376,3377,3388,3398,3408,3418],{},[112,3378,3379,3382,3385],{},[127,3380,3381],{},"Hue",[127,3383,3384],{},"Random hue shift per object.",[127,3386,3387],{},"0, range 0 to 1",[112,3389,3390,3393,3396],{},[127,3391,3392],{},"Saturation",[127,3394,3395],{},"Random saturation change per object.",[127,3397,3387],{},[112,3399,3400,3403,3406],{},[127,3401,3402],{},"Brightness",[127,3404,3405],{},"Random brightness change per object.",[127,3407,3387],{},[112,3409,3410,3413,3416],{},[127,3411,3412],{},"Flip X",[127,3414,3415],{},"Mirrors a random half of the objects left to right.",[127,3417,3283],{},[112,3419,3420,3423,3426],{},[127,3421,3422],{},"Flip Y",[127,3424,3425],{},"Mirrors a random half of the objects top to bottom.",[127,3427,3283],{},[12,3429,3431],{"id":3430},"what-the-add-on-creates-in-your-file","What the add-on creates in your file",[106,3433,3434,3444],{},[109,3435,3436],{},[112,3437,3438,3441],{},[115,3439,3440],{},"Name",[115,3442,3443],{},"What it is",[122,3445,3446,3455,3464,3473],{},[112,3447,3448,3452],{},[127,3449,3450],{},[456,3451,1797],{},[127,3453,3454],{},"The packed atlas image",[112,3456,3457,3461],{},[127,3458,3459],{},[456,3460,1793],{},[127,3462,3463],{},"The shared material, used in slot 1 of each affected object",[112,3465,3466,3470],{},[127,3467,3468],{},[456,3469,1801],{},[127,3471,3472],{},"Custom property on separate objects holding the image index (the first image is 0)",[112,3474,3475,3479],{},[127,3476,3477],{},[456,3478,478],{},[127,3480,3481,3482,3485,3486,3488],{},"Geometry Nodes modifier on the host, using the node group ",[456,3483,3484],{},"IPI_Assign_Index"," with inputs Image Count, Shuffle, Seed and Shuffle Step. It stores ",[456,3487,1801],{}," on every instance.",[17,3490,3491,3492,3494,3495,90],{},"For recipes, see the ",[86,3493,1675],{"href":561},". For problems, see ",[86,3496,629],{"href":628},[12,3498,1126],{"id":1125},[33,3500,3501,3505,3509],{},[36,3502,1131,3503],{},[86,3504,715],{"href":716},[36,3506,3507],{},[86,3508,370],{"href":628},[36,3510,379,3511],{},[86,3512,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":3514},[3515,3516,3517,3518,3519,3520,3521,3522],{"id":2959,"depth":387,"text":2960},{"id":3081,"depth":387,"text":3082},{"id":3157,"depth":387,"text":1760},{"id":3231,"depth":387,"text":1763},{"id":3318,"depth":387,"text":1766},{"id":3359,"depth":387,"text":1769},{"id":3430,"depth":387,"text":3431},{"id":1125,"depth":387,"text":1126},"Every field, button and option of the Image Per Instance panel in Blender: atlas settings, material, animation and random variation, with defaults and ranges.",{},"---\ntitle: \"Image Per Instance panel reference\"\ndescription: \"Every field, button and option of the Image Per Instance panel in Blender: atlas settings, material, animation and random variation, with defaults and ranges.\"\naddon: image-per-instance\norder: 3\nupdated: 2026-11-16\n---\n\nAll controls live in the 3D viewport sidebar (**N**), in the **Image Per Instance** tab. This page follows the panel from top to bottom. Version 0.2.0.\n\n## Main panel: atlas settings\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Image Folder | Folder with your images. Only files directly inside it are read, not subfolders. Supported types: png, jpg, jpeg, tif, tiff, bmp, webp, exr, tga. | empty |\n| Tile Size | Size of one atlas tile in pixels: 128, 256, 512, 1024 or 2048. With a non-square Tile Shape this is the length of the longer side. | 512 px |\n| Tile Shape | Shape of one tile: 1 : 1, 2 : 3, 3 : 2, 3 : 4, 4 : 3, 16 : 9 or 9 : 16. Pick the shape of your frames, covers or screens. | 1 : 1 |\n| Fit | What happens when an image has a different shape than the tile. **Stretch** fills the tile and distorts the image. **Fit (bars)** shows the whole image with bars around it. **Fill (crop)** covers the whole tile and crops the edges. | Stretch |\n| Bar Colour | Colour of the bars. Only shown when Fit is **Fit (bars)**. | black, 0 to 1 per channel |\n| Padding | Edge padding in pixels that hides bleeding between neighbouring tiles. | 4, range 0 to 32 |\n| Order | **By file name** or **Shuffle**. Shuffle uses every image once before any repeats. It changes which image an object or instance gets, not the order inside the atlas. | By file name |\n| Seed | Picks the shuffled arrangement. Only shown when Order is **Shuffle**. | 1 |\n\n## Main panel: buttons and labels\n\n| Control | What it does |\n|---|---|\n| Build Atlas | Packs all images from the folder into one atlas and creates the shared material. The atlas is always in natural file-name order, so Image Number N is the N-th file. Pressing it again replaces the atlas. Objects keep the picture they showed, matched by file name. |\n| Atlas label | Shows \"Atlas: N images\", or \"Atlas: not built\" before the first build. |\n| Apply To Selected Objects | Gives each selected mesh object its own image and puts the shared material on it. With Order **By file name**, objects are sorted by name (natural order) and get images 1, 2, 3 and so on, wrapping around when there are more objects than images. With **Shuffle**, the objects are shuffled using the Seed. |\n| Add To Instances (Geometry Nodes) | The active object is the host with your Array or Instance on Points modifier. The add-on finds the instanced source objects, sets the shared material on them, and adds a modifier named \"IPI Assign Index\" on the host. Selected mesh objects are added as sources too. Press it again after changing Seed or Order to update the modifier. |\n| \"Press again after changing Seed to re-shuffle\" | A hint. Change Seed, then press Apply To Selected Objects or Add To Instances again. |\n| Version label | \"Image Per Instance v\" followed by the version number. |\n\nHow the atlas is laid out: the number of columns is chosen from the image count and the tile shape, so the atlas stays roughly square. The atlas image is named `IPI_Atlas`, the material `IPI_Material`. The atlas can be at most 16384 px on each side.\n\n## Choose Images Yourself\n\nCollapsed by default. Applies to separate objects only, as the panel says.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Image Number | Number of the image in the atlas. 1 is the first file. Changing it updates the Image field. | 1, minimum 1 |\n| Image (search field) | Pick the image by file name, you can type to search. Choosing a name sets Image Number. | empty |\n| Assign Image To Selected | Gives every selected mesh object the image with the chosen number, and the shared material. Fails with a message if the number is higher than the number of images. | |\n| Match By Object Name | Each selected object gets the image whose file name equals the object name. If there is no exact match, the longest file name that appears as a whole word in the object name wins (`card_10` gets `10`, not `1`), then the longest file name contained in the name. A Blender duplicate suffix such as `.001` is ignored, and case does not matter. Objects without a match are listed in the message. | |\n\n## Material\n\nCollapsed by default. These options update the material at once, without pressing a button again, as long as the atlas is built.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Mapping | Where the image sits on the object. **UV Map** uses the object's UV map, which must fill the 0 to 1 square. **Front (no UVs)**, **Top (no UVs)** and **Side (no UVs)** project the image across the whole object from the front, top or right side. | UV Map |\n| Use Image Alpha | PNG transparency cuts the shape out (stickers, round cards, the bars of Fit mode). Sets the material render method to Dithered. | off |\n| Emissive (screen) | The image glows by itself, for video walls, billboards and screens. | off |\n| Strength | Emission strength. Only shown when Emissive is on. | 1.0, minimum 0, soft maximum 10 |\n| Roughness | Roughness of the material. | 0.5, range 0 to 1 |\n\n## Animate\n\nCollapsed by default. The checkbox in the sub-panel header switches animation on.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Animate (checkbox) | Every object steps through the images over time, each starting at its own image. | off |\n| Frames Per Image | How many frames each image stays before the next one. | 24, minimum 1, soft maximum 240 |\n\n## Random Variation\n\nCollapsed by default. All values start at zero, which adds no nodes to the material.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Hue | Random hue shift per object. | 0, range 0 to 1 |\n| Saturation | Random saturation change per object. | 0, range 0 to 1 |\n| Brightness | Random brightness change per object. | 0, range 0 to 1 |\n| Flip X | Mirrors a random half of the objects left to right. | off |\n| Flip Y | Mirrors a random half of the objects top to bottom. | off |\n\n## What the add-on creates in your file\n\n| Name | What it is |\n|---|---|\n| `IPI_Atlas` | The packed atlas image |\n| `IPI_Material` | The shared material, used in slot 1 of each affected object |\n| `img_index` | Custom property on separate objects holding the image index (the first image is 0) |\n| `IPI Assign Index` | Geometry Nodes modifier on the host, using the node group `IPI_Assign_Index` with inputs Image Count, Shuffle, Seed and Shuffle Step. It stores `img_index` on every instance. |\n\nFor recipes, see the [workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows). For problems, see [troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":2945,"description":3523},"docs\u002Fimage-per-instance\u002Fpanel","N-1LWe8YGeCnfGgAY49syq9q-tLfOayf5wOWzx0sG1k",{"id":3530,"title":3531,"addon":1325,"body":3532,"description":4120,"extension":403,"meta":4121,"navigation":408,"order":1152,"path":792,"rawbody":4122,"seo":4123,"stem":4124,"updated":417,"__hash__":4125},"docs\u002Fdocs\u002Fquadfix\u002Fpanel.md","QuadFix panel reference: every option",{"type":9,"value":3533,"toc":4108},[3534,3538,3546,3567,3578,3581,3584,3608,3611,3614,3641,3644,3648,3692,3695,3709,3715,3719,3772,3778,3781,3801,3806,3810,3874,3877,3880,3889,3893,3948,3951,3954,3971,3976,3979,4034,4040,4054,4064,4067,4071,4088,4090],[12,3535,3537],{"id":3536},"layout-of-the-tab","Layout of the tab",[17,3539,832,3540,3542,3543,3545],{},[28,3541,747],{}," tab in the 3D viewport sidebar (",[456,3544,1378],{},") has three panels, from top to bottom:",[980,3547,3548,3553,3559],{},[36,3549,3550,3552],{},[28,3551,747],{},": the Edit Mode tools, described below.",[36,3554,3555,3558],{},[28,3556,3557],{},"Union (Object Mode)",": the Union to Quads tool.",[36,3560,3561,3563,3564,90],{},[28,3562,2060],{},": a footer with the version and the result of the last operation. Before any run it reads ",[456,3565,3566],{},"Last result: none yet",[17,3568,3569,3570,3573,3574,3577],{},"In Object Mode the first panel shows ",[456,3571,3572],{},"Edit Mode tools: press Tab"," and its controls are greyed out. In Edit Mode the union panel shows ",[456,3575,3576],{},"Object Mode tool: press Tab"," and is greyed out. Every tool therefore stays visible, but only the ones that fit the current mode can be pressed.",[17,3579,3580],{},"All operations are normal Blender undo steps.",[12,3582,1417],{"id":3583},"only-selected",[106,3585,3586,3597],{},[109,3587,3588],{},[112,3589,3590,3592,3594],{},[115,3591,2265],{},[115,3593,447],{},[115,3595,3596],{},"Default",[122,3598,3599],{},[112,3600,3601,3603,3606],{},[127,3602,1417],{},[127,3604,3605],{},"Restricts the tools to the selected geometry. Off means the whole mesh.",[127,3607,2576],{},[17,3609,3610],{},"It applies to Fill Holes, N-gons to Quads and Clean & Quad. Select Non-Quads & Holes always looks at the whole mesh, and Bridge to Quads always uses the selected edges.",[12,3612,779],{"id":3613},"select-non-quads-holes",[106,3615,3616,3626],{},[109,3617,3618],{},[112,3619,3620,3622,3624],{},[115,3621,2265],{},[115,3623,447],{},[115,3625,3596],{},[122,3627,3628],{},[112,3629,3630,3632,3638],{},[127,3631,779],{},[127,3633,3634,3635,90],{},"Clears the selection, then selects every face that is not a quad (triangles and n-gons) and every boundary edge (open hole edges). The counts appear in the footer as ",[456,3636,3637],{},"N non-quad faces, N boundary edges",[127,3639,3640],{},"Button",[17,3642,3643],{},"Use it first to see what needs work, and again at the end to check what remains. Note that the outer rim of an open sheet counts as boundary edges too.",[12,3645,3647],{"id":3646},"holes","Holes",[106,3649,3650,3660],{},[109,3651,3652],{},[112,3653,3654,3656,3658],{},[115,3655,2265],{},[115,3657,447],{},[115,3659,2270],{},[122,3661,3662,3671,3682],{},[112,3663,3664,3666,3669],{},[127,3665,755],{},[127,3667,3668],{},"Fills open holes and closed boundary loops with quads. It grows a grid across the hole, relaxes it onto the surface around it and checks the result for folds. Gaps between two loops (for example a cut band) are bridged. Odd loops are handled.",[127,3670,3640],{},[112,3672,3673,3676,3679],{},[127,3674,3675],{},"Grid Span",[127,3677,3678],{},"Number of grid columns used for the grid fill. 0 lets QuadFix choose.",[127,3680,3681],{},"0, minimum 0",[112,3683,3684,3687,3690],{},[127,3685,3686],{},"Match Triangle Meshes",[127,3688,3689],{},"When at least 70 percent of the faces around the filled area are triangles (a scan), the new patch is triangulated too, so it blends in. Turn it off to keep quads.",[127,3691,2576],{},[17,3693,3694],{},"What gets filled: with Only Selected on, a hole is filled only when its whole boundary loop is selected. A half-selected loop is skipped and counted in the report. The outer border of a flat open sheet, such as a plane, terrain or cloth, is skipped as not being a hole. Round holes on curved surfaces, band cuts, stepped holes and rings between two loops are rebuilt as grids.",[17,3696,3697,3698,3701,3702,674,3705,3708],{},"The footer reads, for example, ",[456,3699,3700],{},"Filled 2 loop(s). Now: 1480 quads \u002F 12 tris \u002F 0 n-gons",". If nothing qualifies you see ",[456,3703,3704],{},"No boundary edges (holes) in selection",[456,3706,3707],{},"Nothing to fill:"," with the reason (outer borders, partly selected holes).",[3710,3711,3712],"blockquote",{},[17,3713,3714],{},"Fill Holes fills every fully selected closed loop, including openings you may not think of as holes, such as eye sockets on a character mesh. Select only the holes you want.",[12,3716,3718],{"id":3717},"bridge","Bridge",[106,3720,3721,3731],{},[109,3722,3723],{},[112,3724,3725,3727,3729],{},[115,3726,2265],{},[115,3728,447],{},[115,3730,2270],{},[122,3732,3733,3742,3752,3762],{},[112,3734,3735,3737,3740],{},[127,3736,761],{},[127,3738,3739],{},"Connects two selected edge loops, or two selected open edge chains, with a strip of quads. Needs Edge select mode. Works with unequal edge counts up to 4 to 1.",[127,3741,3640],{},[112,3743,3744,3747,3750],{},[127,3745,3746],{},"Auto Cuts",[127,3748,3749],{},"Adds loops between the two sides so the quads come out roughly square.",[127,3751,2576],{},[112,3753,3754,3756,3759],{},[127,3755,2542],{},[127,3757,3758],{},"Number of loops added between the sides. Only used when Auto Cuts is off.",[127,3760,3761],{},"0, range 0 to 64",[112,3763,3764,3767,3770],{},[127,3765,3766],{},"Smoothness",[127,3768,3769],{},"0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them.",[127,3771,3387],{},[17,3773,3774,3775,90],{},"The three options appear in Blender's Adjust Last Operation panel after you run Bridge to Quads, so you can change them and see the result update. The panel itself shows the hint ",[456,3776,3777],{},"Select two edge loops or chains",[17,3779,3780],{},"Notes on how it behaves:",[33,3782,3783,3786,3789,3792,3795,3798],{},[36,3784,3785],{},"Both sides must be the same kind: two closed loops or two open chains.",[36,3787,3788],{},"Where the counts differ, quads are reduced in rows of up to 3 to 1. A bigger ratio gets extra rows in between. If the total number of edges on both sides is odd, one triangle is unavoidable and it is selected with the strip.",[36,3790,3791],{},"On tubes the default straight strip (Smoothness 0) is the cleanest. Raise Smoothness where the two sides are tilted against each other. If a smoothed strip would fold, QuadFix falls back to the straight strip and says so in the report.",[36,3793,3794],{},"The result is checked for non-quads, non-manifold edges, zero-area faces, folds, twists and inconsistent winding. If a check fails, the strip is removed and the edges that caused the problem are selected.",[36,3796,3797],{},"Material and smooth shading of the new faces are copied from the faces beside each side.",[36,3799,3800],{},"A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.",[17,3802,3697,3803,90],{},[456,3804,3805],{},"Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s)",[12,3807,3809],{"id":3808},"quads","Quads",[106,3811,3812,3822],{},[109,3813,3814],{},[112,3815,3816,3818,3820],{},[115,3817,2265],{},[115,3819,447],{},[115,3821,2270],{},[122,3823,3824,3833,3844,3854,3864],{},[112,3825,3826,3828,3831],{},[127,3827,767],{},[127,3829,3830],{},"Triangulates the selected triangles and n-gons and joins the triangles into quads.",[127,3832,3640],{},[112,3834,3835,3838,3841],{},[127,3836,3837],{},"Face Angle",[127,3839,3840],{},"Largest angle between the normals of two triangles that may be joined into a quad.",[127,3842,3843],{},"90 degrees, range 0 to 180",[112,3845,3846,3849,3852],{},[127,3847,3848],{},"Shape Angle",[127,3850,3851],{},"Largest deviation from a rectangle that is accepted for a new quad.",[127,3853,3843],{},[112,3855,3856,3859,3862],{},[127,3857,3858],{},"Keep Planar N-gons",[127,3860,3861],{},"Leaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans.",[127,3863,2576],{},[112,3865,3866,3869,3872],{},[127,3867,3868],{},"Aggressive Quads",[127,3870,3871],{},"Joins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes.",[127,3873,2298],{},[17,3875,3876],{},"Lower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.",[17,3878,3879],{},"A large n-gon that came from dissolving a rectangular patch of a grid (a clean rectangle of at least 8 corners with equal opposite sides) is opened and refilled like a hole, so the grid is rebuilt instead of turning into a diamond pattern. If that fill fails, the n-gon is put back and converted the usual way.",[17,3881,3697,3882,3885,3886,90],{},[456,3883,3884],{},"n-gons 4→0, tris 120→8, quads 300→412",". With nothing to do you see ",[456,3887,3888],{},"Nothing to convert (all quads or flat n-gons)",[12,3890,3892],{"id":3891},"boolean-import-cleanup","Boolean \u002F Import Cleanup",[106,3894,3895,3905],{},[109,3896,3897],{},[112,3898,3899,3901,3903],{},[115,3900,2265],{},[115,3902,447],{},[115,3904,2270],{},[122,3906,3907,3916,3927,3938],{},[112,3908,3909,3911,3914],{},[127,3910,773],{},[127,3912,3913],{},"Runs the cleanup chain described below.",[127,3915,3640],{},[112,3917,3918,3921,3924],{},[127,3919,3920],{},"Merge Distance",[127,3922,3923],{},"Vertices closer than this are merged. Also the threshold for removing degenerate geometry.",[127,3925,3926],{},"0.0001, minimum 0, shown with 5 decimals",[112,3928,3929,3932,3935],{},[127,3930,3931],{},"Dissolve Angle",[127,3933,3934],{},"Angle for the limited dissolve.",[127,3936,3937],{},"5 degrees, range 0 to 90",[112,3939,3940,3943,3946],{},[127,3941,3942],{},"Keep Sharp Edges",[127,3944,3945],{},"Does not dissolve edges marked sharp or seam.",[127,3947,2576],{},[17,3949,3950],{},"The Face Angle, Shape Angle, Keep Planar N-gons and Aggressive Quads options from the Quads box also apply to the triangle-joining step of Clean & Quad.",[17,3952,3953],{},"In order, Clean & Quad:",[980,3955,3956,3959,3962,3965,3968],{},[36,3957,3958],{},"Merges doubles within Merge Distance.",[36,3960,3961],{},"Dissolves degenerate geometry and deletes loose edges and vertices.",[36,3963,3964],{},"Applies a limited dissolve at the Dissolve Angle, only around triangles and n-gons and open edges. Between two quads the grid is already clean and is left alone, and triangle fans at poles of spheres and cylinder caps are recognised as clean and kept.",[36,3966,3967],{},"Triangulates the remaining non-quads and joins them into quads. Flat n-gons that were already in the mesh stay when Keep Planar N-gons is on, while n-gons created by the dissolve are always converted.",[36,3969,3970],{},"Recalculates the face normals.",[17,3972,3697,3973,90],{},[456,3974,3975],{},"verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0",[12,3977,3557],{"id":3978},"union-object-mode",[106,3980,3981,3991],{},[109,3982,3983],{},[112,3984,3985,3987,3989],{},[115,3986,2265],{},[115,3988,447],{},[115,3990,2270],{},[122,3992,3993,4002,4013,4024],{},[112,3994,3995,3997,4000],{},[127,3996,785],{},[127,3998,3999],{},"Needs at least two selected mesh objects. The active object stays and receives the others. Runs an exact Boolean union and rebuilds every seam as a strip of quads.",[127,4001,3640],{},[112,4003,4004,4007,4010],{},[127,4005,4006],{},"Rings",[127,4008,4009],{},"Number of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result.",[127,4011,4012],{},"Auto, or 1, 2, 3",[112,4014,4015,4018,4021],{},[127,4016,4017],{},"Max Shape Change %",[127,4019,4020],{},"Largest distance the rebuilt seam may move from the plain Boolean surface, in percent of the object size. A seam that would move more is rejected and stays a plain Boolean.",[127,4022,4023],{},"2.0, range 0.1 to 20",[112,4025,4026,4029,4032],{},[127,4027,4028],{},"Keep Originals Hidden",[127,4030,4031],{},"Hides the other selected objects instead of deleting them.",[127,4033,2576],{},[17,4035,4036,4037,90],{},"The three options appear in Adjust Last Operation after the run. The panel itself shows ",[456,4038,4039],{},"Select 2+ meshes, the active one stays",[17,4041,4042,4043,4046,4047,1408,4050,4053],{},"How it works: each object gets its own marker materials during the Boolean so that the seam is exactly where faces from different objects meet. Materials are restored afterwards. The result replaces the mesh of the active object (the new mesh is named after the old one with ",[456,4044,4045],{},"_union"," at the end). The other objects are hidden, and ",[28,4048,4049],{},"Object > Show\u002FHide > Reveal Hidden",[456,4051,4052],{},"Alt+H",") brings them back.",[17,4055,3697,4056,4059,4060,4063],{},[456,4057,4058],{},"Union: 2 seam loop(s) rebuilt. Mesh: quads 1820, tris 6, n-gons 0",". If some seams could not be rebuilt cleanly the text adds ",[456,4061,4062],{},"N left as plain boolean"," and the message is a warning.",[17,4065,4066],{},"Limits: UVs are not generated for the new strip. Seams that run through holes in your input are skipped. On very dense meshes with different density on the two sides the strip is all quads but zig-zags. Closed, overlapping meshes work best.",[12,4068,4070],{"id":4069},"where-to-go-next","Where to go next",[33,4072,4073,4078,4083],{},[36,4074,4075,4076,90],{},"Step-by-step use of these tools: ",[86,4077,1675],{"href":796},[36,4079,4080,4081,90],{},"Something refused or looked wrong: ",[86,4082,629],{"href":835},[36,4084,4085,4086,90],{},"Overview and price: ",[86,4087,1337],{"href":949},[12,4089,1126],{"id":1125},[33,4091,4092,4096,4100],{},[36,4093,1131,4094],{},[86,4095,747],{"href":949},[36,4097,4098],{},[86,4099,370],{"href":835},[36,4101,1461,4102,305,4104,612,4106],{},[86,4103,1464],{"href":858},[86,4105,1467],{"href":865},[86,4107,1470],{"href":872},{"title":386,"searchDepth":387,"depth":387,"links":4109},[4110,4111,4112,4113,4114,4115,4116,4117,4118,4119],{"id":3536,"depth":387,"text":3537},{"id":3583,"depth":387,"text":1417},{"id":3613,"depth":387,"text":779},{"id":3646,"depth":387,"text":3647},{"id":3717,"depth":387,"text":3718},{"id":3808,"depth":387,"text":3809},{"id":3891,"depth":387,"text":3892},{"id":3978,"depth":387,"text":3557},{"id":4069,"depth":387,"text":4070},{"id":1125,"depth":387,"text":1126},"Reference for every QuadFix control in Blender: Only Selected, Select Non-Quads & Holes, Fill Holes, Bridge, N-gons to Quads, Clean & Quad and Union to Quads.",{},"---\ntitle: \"QuadFix panel reference: every option\"\ndescription: \"Reference for every QuadFix control in Blender: Only Selected, Select Non-Quads & Holes, Fill Holes, Bridge, N-gons to Quads, Clean & Quad and Union to Quads.\"\naddon: quadfix\norder: 3\nupdated: 2026-11-16\n---\n\n## Layout of the tab\n\nThe **QuadFix** tab in the 3D viewport sidebar (`N`) has three panels, from top to bottom:\n\n1. **QuadFix**: the Edit Mode tools, described below.\n2. **Union (Object Mode)**: the Union to Quads tool.\n3. **QuadFix v1.4.5**: a footer with the version and the result of the last operation. Before any run it reads `Last result: none yet`.\n\nIn Object Mode the first panel shows `Edit Mode tools: press Tab` and its controls are greyed out. In Edit Mode the union panel shows `Object Mode tool: press Tab` and is greyed out. Every tool therefore stays visible, but only the ones that fit the current mode can be pressed.\n\nAll operations are normal Blender undo steps.\n\n## Only Selected\n\n| Control | What it does | Default |\n|---|---|---|\n| Only Selected | Restricts the tools to the selected geometry. Off means the whole mesh. | On |\n\nIt applies to Fill Holes, N-gons to Quads and Clean & Quad. Select Non-Quads & Holes always looks at the whole mesh, and Bridge to Quads always uses the selected edges.\n\n## Select Non-Quads & Holes\n\n| Control | What it does | Default |\n|---|---|---|\n| Select Non-Quads & Holes | Clears the selection, then selects every face that is not a quad (triangles and n-gons) and every boundary edge (open hole edges). The counts appear in the footer as `N non-quad faces, N boundary edges`. | Button |\n\nUse it first to see what needs work, and again at the end to check what remains. Note that the outer rim of an open sheet counts as boundary edges too.\n\n## Holes\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Fill Holes with Quads | Fills open holes and closed boundary loops with quads. It grows a grid across the hole, relaxes it onto the surface around it and checks the result for folds. Gaps between two loops (for example a cut band) are bridged. Odd loops are handled. | Button |\n| Grid Span | Number of grid columns used for the grid fill. 0 lets QuadFix choose. | 0, minimum 0 |\n| Match Triangle Meshes | When at least 70 percent of the faces around the filled area are triangles (a scan), the new patch is triangulated too, so it blends in. Turn it off to keep quads. | On |\n\nWhat gets filled: with Only Selected on, a hole is filled only when its whole boundary loop is selected. A half-selected loop is skipped and counted in the report. The outer border of a flat open sheet, such as a plane, terrain or cloth, is skipped as not being a hole. Round holes on curved surfaces, band cuts, stepped holes and rings between two loops are rebuilt as grids.\n\nThe footer reads, for example, `Filled 2 loop(s). Now: 1480 quads \u002F 12 tris \u002F 0 n-gons`. If nothing qualifies you see `No boundary edges (holes) in selection` or `Nothing to fill:` with the reason (outer borders, partly selected holes).\n\n> Fill Holes fills every fully selected closed loop, including openings you may not think of as holes, such as eye sockets on a character mesh. Select only the holes you want.\n\n## Bridge\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Bridge to Quads | Connects two selected edge loops, or two selected open edge chains, with a strip of quads. Needs Edge select mode. Works with unequal edge counts up to 4 to 1. | Button |\n| Auto Cuts | Adds loops between the two sides so the quads come out roughly square. | On |\n| Cuts | Number of loops added between the sides. Only used when Auto Cuts is off. | 0, range 0 to 64 |\n| Smoothness | 0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them. | 0, range 0 to 1 |\n\nThe three options appear in Blender's Adjust Last Operation panel after you run Bridge to Quads, so you can change them and see the result update. The panel itself shows the hint `Select two edge loops or chains`.\n\nNotes on how it behaves:\n\n- Both sides must be the same kind: two closed loops or two open chains.\n- Where the counts differ, quads are reduced in rows of up to 3 to 1. A bigger ratio gets extra rows in between. If the total number of edges on both sides is odd, one triangle is unavoidable and it is selected with the strip.\n- On tubes the default straight strip (Smoothness 0) is the cleanest. Raise Smoothness where the two sides are tilted against each other. If a smoothed strip would fold, QuadFix falls back to the straight strip and says so in the report.\n- The result is checked for non-quads, non-manifold edges, zero-area faces, folds, twists and inconsistent winding. If a check fails, the strip is removed and the edges that caused the problem are selected.\n- Material and smooth shading of the new faces are copied from the faces beside each side.\n- A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.\n\nThe footer reads, for example, `Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s)`.\n\n## Quads\n\n| Control | What it does | Default and range |\n|---|---|---|\n| N-gons to Quads | Triangulates the selected triangles and n-gons and joins the triangles into quads. | Button |\n| Face Angle | Largest angle between the normals of two triangles that may be joined into a quad. | 90 degrees, range 0 to 180 |\n| Shape Angle | Largest deviation from a rectangle that is accepted for a new quad. | 90 degrees, range 0 to 180 |\n| Keep Planar N-gons | Leaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans. | On |\n| Aggressive Quads | Joins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes. | Off |\n\nLower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.\n\nA large n-gon that came from dissolving a rectangular patch of a grid (a clean rectangle of at least 8 corners with equal opposite sides) is opened and refilled like a hole, so the grid is rebuilt instead of turning into a diamond pattern. If that fill fails, the n-gon is put back and converted the usual way.\n\nThe footer reads, for example, `n-gons 4→0, tris 120→8, quads 300→412`. With nothing to do you see `Nothing to convert (all quads or flat n-gons)`.\n\n## Boolean \u002F Import Cleanup\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Clean & Quad (Boolean Prep) | Runs the cleanup chain described below. | Button |\n| Merge Distance | Vertices closer than this are merged. Also the threshold for removing degenerate geometry. | 0.0001, minimum 0, shown with 5 decimals |\n| Dissolve Angle | Angle for the limited dissolve. | 5 degrees, range 0 to 90 |\n| Keep Sharp Edges | Does not dissolve edges marked sharp or seam. | On |\n\nThe Face Angle, Shape Angle, Keep Planar N-gons and Aggressive Quads options from the Quads box also apply to the triangle-joining step of Clean & Quad.\n\nIn order, Clean & Quad:\n\n1. Merges doubles within Merge Distance.\n2. Dissolves degenerate geometry and deletes loose edges and vertices.\n3. Applies a limited dissolve at the Dissolve Angle, only around triangles and n-gons and open edges. Between two quads the grid is already clean and is left alone, and triangle fans at poles of spheres and cylinder caps are recognised as clean and kept.\n4. Triangulates the remaining non-quads and joins them into quads. Flat n-gons that were already in the mesh stay when Keep Planar N-gons is on, while n-gons created by the dissolve are always converted.\n5. Recalculates the face normals.\n\nThe footer reads, for example, `verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0`.\n\n## Union (Object Mode)\n\n| Control | What it does | Default and range |\n|---|---|---|\n| Union to Quads | Needs at least two selected mesh objects. The active object stays and receives the others. Runs an exact Boolean union and rebuilds every seam as a strip of quads. | Button |\n| Rings | Number of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result. | Auto, or 1, 2, 3 |\n| Max Shape Change % | Largest distance the rebuilt seam may move from the plain Boolean surface, in percent of the object size. A seam that would move more is rejected and stays a plain Boolean. | 2.0, range 0.1 to 20 |\n| Keep Originals Hidden | Hides the other selected objects instead of deleting them. | On |\n\nThe three options appear in Adjust Last Operation after the run. The panel itself shows `Select 2+ meshes, the active one stays`.\n\nHow it works: each object gets its own marker materials during the Boolean so that the seam is exactly where faces from different objects meet. Materials are restored afterwards. The result replaces the mesh of the active object (the new mesh is named after the old one with `_union` at the end). The other objects are hidden, and **Object > Show\u002FHide > Reveal Hidden** (`Alt+H`) brings them back.\n\nThe footer reads, for example, `Union: 2 seam loop(s) rebuilt. Mesh: quads 1820, tris 6, n-gons 0`. If some seams could not be rebuilt cleanly the text adds `N left as plain boolean` and the message is a warning.\n\nLimits: UVs are not generated for the new strip. Seams that run through holes in your input are skipped. On very dense meshes with different density on the two sides the strip is all quads but zig-zags. Closed, overlapping meshes work best.\n\n## Where to go next\n\n- Step-by-step use of these tools: [workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows).\n- Something refused or looked wrong: [troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting).\n- Overview and price: [QuadFix product page](\u002Faddons\u002Fquadfix).\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":3531,"description":4120},"docs\u002Fquadfix\u002Fpanel","Tf8eiqn-ALmSnySIKrsT520o6c231qEdFmf767Owd2Y",{"id":4127,"title":4128,"addon":962,"body":4129,"description":4388,"extension":403,"meta":4389,"navigation":408,"order":4390,"path":363,"rawbody":4391,"seo":4392,"stem":4393,"updated":417,"__hash__":4394},"docs\u002Fdocs\u002Fbedsplit\u002Fworkflows.md","BedSplit workflows: model to printed parts",{"type":9,"value":4130,"toc":4379},[4131,4135,4138,4176,4179,4183,4186,4214,4220,4225,4229,4235,4262,4268,4272,4281,4292,4295,4299,4318,4321,4325,4328,4354,4363,4365],[12,4132,4134],{"id":4133},"fit-a-figure-to-a-220-mm-bed","Fit a figure to a 220 mm bed",[17,4136,4137],{},"Say you have a 600 mm tall statue and an Ender 3 class printer.",[980,4139,4140,4148,4154,4166,4170],{},[36,4141,4142,4143,4145,4146,1382],{},"Select the statue in Object Mode. Press ",[28,4144,1378],{}," and open the ",[28,4147,407],{},[36,4149,4150,4151,4153],{},"In ",[28,4152,2256],{}," choose \"Creality Ender 3 \u002F V3 SE (220 × 220 × 250)\". This is also the default.",[36,4155,4156,4157,4159,4160,4162,4163,4165],{},"Under ",[28,4158,2488],{}," turn on ",[28,4161,190],{}," and set ",[28,4164,2526],{}," to 600. If the model is already modelled at real size, leave it off. The line \"Now: ... mm longest side\" shows what Blender currently thinks.",[36,4167,1005,4168,90],{},[28,4169,30],{},[36,4171,4172,4173,4175],{},"Look at the ",[28,4174,1011],{}," panel. Each part row shows its size and a check mark. The parts sit in a grid beside the model, each lying on a cut face.",[17,4177,4178],{},"Because the bed is 250 mm high, a 600 mm model needs three slabs along its tall axis. BedSplit uses the smallest number of slabs per axis that fits the bed.",[12,4180,4182],{"id":4181},"preview-and-choose-the-cuts","Preview and choose the cuts",[17,4184,4185],{},"Automatic cuts are a starting point. To control where the model is cut:",[980,4187,4188,4196,4199,4202,4209],{},[36,4189,1005,4190,4192,4193,4195],{},[28,4191,50],{},". Planes appear in the viewport and a row per plane appears in the ",[28,4194,2542],{}," box.",[36,4197,4198],{},"Read the row: the letter is the axis and the number is millimetres from the start of the model along it.",[36,4200,4201],{},"Edit the number to slide a plane. Typical reasons: keep a cut away from a face, a hand, a thin sword blade, or put a seam where it is easy to hide.",[36,4203,4204,4205,4208],{},"Remove a plane with the X button, or press ",[28,4206,4207],{},"Add cut"," X, Y or Z to add one in the middle of the largest remaining piece, then move it.",[36,4210,1005,4211,4213],{},[28,4212,30],{},". It uses your list exactly.",[17,4215,4216,4217,4219],{},"Two things to remember. Your own cut list is not checked against the bed, so if you move a plane too far a part may end up larger than the bed and the result panel will say so. And if you move or scale the source object, or change the printer or size settings, the list is discarded and the panel shows ",[28,4218,2607],{}," again.",[3710,4221,4222],{},[17,4223,4224],{},"Tip: if a cut passes through a very thin section, the dowel may not fit there. Slide the plane a few millimetres to a thicker section and split again.",[12,4226,4228],{"id":4227},"add-dowels","Add dowels",[17,4230,4231,4232,4234],{},"Dowels are on by default. The ",[28,4233,2646],{}," box sets them:",[980,4236,4237,4242,4247,4252,4257],{},[36,4238,4239,4241],{},[28,4240,2665],{},": 6 is a good start. A larger dowel is stronger but needs thicker walls.",[36,4243,4244,4246],{},[28,4245,2676],{},": 6 means the dowel is 12 mm long and goes 6 mm into each side.",[36,4248,4249,4251],{},[28,4250,2687],{},": 0.2 suits most printers. If you printed the dowels and they do not enter the sockets, raise it in steps, for example to 0.3, and split again.",[36,4253,4254,4256],{},[28,4255,2698],{},": 2 gives alignment against twisting. Use 1 to keep sockets away from thin areas, or 3 for large faces.",[36,4258,1005,4259,4261],{},[28,4260,30],{}," again after any change. The settings are applied during the split, not live.",[17,4263,4264,4265,4267],{},"After the split read the ",[28,4266,1011],{}," panel for a line such as \"N joint(s) without dowel (wall too thin): glue these\". Those joints are plain flat faces.",[12,4269,4271],{"id":4270},"repair-and-check","Repair and check",[17,4273,4274,4275,4277,4278,4280],{},"You do not run a separate repair. ",[28,4276,30],{}," repairs first and reports it in the ",[28,4279,1011],{}," panel:",[33,4282,4283,4286,4289],{},[36,4284,4285],{},"\"Repaired: holes closed, normals fixed\" or \"Repaired: overlapping shells joined\" are mild and keep the shape.",[36,4287,4288],{},"\"Repaired: surface rebuilt (within x mm)\" means the mesh was rebuilt as a new surface, within x millimetres of the original.",[36,4290,4291],{},"\"Heavy repair ... fine detail smoothed\" means the rebuild moved the surface more than 0.5 mm. Compare the parts to the original. If a feature you care about is lost, repair that area in Blender first and split again.",[17,4293,4294],{},"A clean closed mesh with no problems produces no repair message.",[12,4296,4298],{"id":4297},"export-the-stl-files","Export the STL files",[980,4300,4301,4309,4312,4315],{},[36,4302,4303,4304,4306,4307,90],{},"In the ",[28,4305,1011],{}," panel press ",[28,4308,290],{},[36,4310,4311],{},"Choose a folder. It is created if it does not exist.",[36,4313,4314],{},"You get one file per part (for example \"Knight_part_01.stl\") and one dowel file with the count in its name (for example \"Knight_dowel_x6.stl\"). Everything is in millimetres.",[36,4316,4317],{},"In your slicer import the parts. Each part is already oriented with its cut face on the ground, so no extra rotation is usually needed.",[17,4319,4320],{},"If you slice at a different scale than the export, the parts will not match the sockets, so import at 100 percent.",[12,4322,4324],{"id":4323},"print-and-assemble","Print and assemble",[17,4326,4327],{},"Tips that follow from the dowel settings:",[980,4329,4330,4333,4336,4342,4345,4348,4351],{},[36,4331,4332],{},"Print the dowel file as many times as the name says. The count is the number of dowels in the whole model.",[36,4334,4335],{},"Do a test first: print one small joint pair and one dowel and try the fit. Printers differ.",[36,4337,4338,4339,4341],{},"If a dowel is too tight, raise ",[28,4340,2687],{}," and split again. If it is loose, lower it, though 0.2 mm is the setting the add-on was built around.",[36,4343,4344],{},"Dowels are twice the depth in length, with sockets slightly deeper than the half length, so they bottom out with a small gap rather than jamming.",[36,4346,4347],{},"Use glue on the flat faces, and a little in the sockets. The dowels align the parts, the glue holds them.",[36,4349,4350],{},"Dry fit all parts before gluing. Joints with no dowels need to be aligned by eye.",[36,4352,4353],{},"For joints the panel reported as lacking dowels, glue flat faces and clamp.",[17,4355,2869,4356,4358,4359,4362],{},[86,4357,629],{"href":369}," when something goes wrong, and the guide on ",[86,4360,4361],{"href":382},"splitting a model for 3D printing"," for the manual method.",[12,4364,1126],{"id":1125},[33,4366,4367,4371,4375],{},[36,4368,1131,4369],{},[86,4370,407],{"href":409},[36,4372,4373],{},[86,4374,370],{"href":369},[36,4376,379,4377],{},[86,4378,383],{"href":382},{"title":386,"searchDepth":387,"depth":387,"links":4380},[4381,4382,4383,4384,4385,4386,4387],{"id":4133,"depth":387,"text":4134},{"id":4181,"depth":387,"text":4182},{"id":4227,"depth":387,"text":4228},{"id":4270,"depth":387,"text":4271},{"id":4297,"depth":387,"text":4298},{"id":4323,"depth":387,"text":4324},{"id":1125,"depth":387,"text":1126},"Step-by-step BedSplit workflows: fit a figure to a 220 mm bed, choose cut planes, add dowels, repair and export STL files, and assemble the printed parts.",{},4,"---\ntitle: \"BedSplit workflows: model to printed parts\"\ndescription: \"Step-by-step BedSplit workflows: fit a figure to a 220 mm bed, choose cut planes, add dowels, repair and export STL files, and assemble the printed parts.\"\naddon: bedsplit\norder: 4\nupdated: 2026-11-16\n---\n\n## Fit a figure to a 220 mm bed\n\nSay you have a 600 mm tall statue and an Ender 3 class printer.\n\n1. Select the statue in Object Mode. Press **N** and open the **BedSplit** tab.\n2. In **Printer** choose \"Creality Ender 3 \u002F V3 SE (220 × 220 × 250)\". This is also the default.\n3. Under **Model size** turn on **Resize for print** and set **Longest side, mm** to 600. If the model is already modelled at real size, leave it off. The line \"Now: ... mm longest side\" shows what Blender currently thinks.\n4. Press **Split to Bed**.\n5. Look at the **Result** panel. Each part row shows its size and a check mark. The parts sit in a grid beside the model, each lying on a cut face.\n\nBecause the bed is 250 mm high, a 600 mm model needs three slabs along its tall axis. BedSplit uses the smallest number of slabs per axis that fits the bed.\n\n## Preview and choose the cuts\n\nAutomatic cuts are a starting point. To control where the model is cut:\n\n1. Press **Find Cuts**. Planes appear in the viewport and a row per plane appears in the **Cuts** box.\n2. Read the row: the letter is the axis and the number is millimetres from the start of the model along it.\n3. Edit the number to slide a plane. Typical reasons: keep a cut away from a face, a hand, a thin sword blade, or put a seam where it is easy to hide.\n4. Remove a plane with the X button, or press **Add cut** X, Y or Z to add one in the middle of the largest remaining piece, then move it.\n5. Press **Split to Bed**. It uses your list exactly.\n\nTwo things to remember. Your own cut list is not checked against the bed, so if you move a plane too far a part may end up larger than the bed and the result panel will say so. And if you move or scale the source object, or change the printer or size settings, the list is discarded and the panel shows **Automatic** again.\n\n> Tip: if a cut passes through a very thin section, the dowel may not fit there. Slide the plane a few millimetres to a thicker section and split again.\n\n## Add dowels\n\nDowels are on by default. The **Dowels** box sets them:\n\n1. **Dowel diameter, mm**: 6 is a good start. A larger dowel is stronger but needs thicker walls.\n2. **Depth in each part, mm**: 6 means the dowel is 12 mm long and goes 6 mm into each side.\n3. **Clearance, mm**: 0.2 suits most printers. If you printed the dowels and they do not enter the sockets, raise it in steps, for example to 0.3, and split again.\n4. **Dowels per joint**: 2 gives alignment against twisting. Use 1 to keep sockets away from thin areas, or 3 for large faces.\n5. Press **Split to Bed** again after any change. The settings are applied during the split, not live.\n\nAfter the split read the **Result** panel for a line such as \"N joint(s) without dowel (wall too thin): glue these\". Those joints are plain flat faces.\n\n## Repair and check\n\nYou do not run a separate repair. **Split to Bed** repairs first and reports it in the **Result** panel:\n\n- \"Repaired: holes closed, normals fixed\" or \"Repaired: overlapping shells joined\" are mild and keep the shape.\n- \"Repaired: surface rebuilt (within x mm)\" means the mesh was rebuilt as a new surface, within x millimetres of the original.\n- \"Heavy repair ... fine detail smoothed\" means the rebuild moved the surface more than 0.5 mm. Compare the parts to the original. If a feature you care about is lost, repair that area in Blender first and split again.\n\nA clean closed mesh with no problems produces no repair message.\n\n## Export the STL files\n\n1. In the **Result** panel press **Export STL**.\n2. Choose a folder. It is created if it does not exist.\n3. You get one file per part (for example \"Knight_part_01.stl\") and one dowel file with the count in its name (for example \"Knight_dowel_x6.stl\"). Everything is in millimetres.\n4. In your slicer import the parts. Each part is already oriented with its cut face on the ground, so no extra rotation is usually needed.\n\nIf you slice at a different scale than the export, the parts will not match the sockets, so import at 100 percent.\n\n## Print and assemble\n\nTips that follow from the dowel settings:\n\n1. Print the dowel file as many times as the name says. The count is the number of dowels in the whole model.\n2. Do a test first: print one small joint pair and one dowel and try the fit. Printers differ.\n3. If a dowel is too tight, raise **Clearance, mm** and split again. If it is loose, lower it, though 0.2 mm is the setting the add-on was built around.\n4. Dowels are twice the depth in length, with sockets slightly deeper than the half length, so they bottom out with a small gap rather than jamming.\n5. Use glue on the flat faces, and a little in the sockets. The dowels align the parts, the glue holds them.\n6. Dry fit all parts before gluing. Joints with no dowels need to be aligned by eye.\n7. For joints the panel reported as lacking dowels, glue flat faces and clamp.\n\nSee [troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting) when something goes wrong, and the guide on [splitting a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing) for the manual method.\n\n## Related\n\n- Product page: [BedSplit](\u002Faddons\u002Fbedsplit)\n- [Troubleshooting](\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting)\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing)\n",{"title":4128,"description":4388},"docs\u002Fbedsplit\u002Fworkflows","wHCaJodKU8Sn7ohkvumQWd1lFLj3KNzC_xhcmY7fNXM",{"id":4396,"title":4397,"addon":1164,"body":4398,"description":4735,"extension":403,"meta":4736,"navigation":408,"order":4390,"path":561,"rawbody":4737,"seo":4738,"stem":4739,"updated":417,"__hash__":4740},"docs\u002Fdocs\u002Fimage-per-instance\u002Fworkflows.md","Image Per Instance workflows",{"type":9,"value":4399,"toc":4725},[4400,4411,4415,4418,4462,4470,4474,4477,4499,4505,4509,4536,4539,4545,4549,4607,4611,4629,4641,4645,4690,4694,4709,4711],[17,4401,4402,4403,4405,4406,4408,4409,90],{},"Every recipe starts the same way: open the sidebar with ",[28,4404,1378],{}," and go to the ",[28,4407,715],{}," tab. Names of controls are explained in the ",[86,4410,89],{"href":551},[12,4412,4414],{"id":4413},"different-images-on-separate-objects","Different images on separate objects",[17,4416,4417],{},"Use this for frames on a wall, book covers or cards that are individual objects.",[980,4419,4420,4435,4443,4451,4456],{},[36,4421,4422,4423,305,4426,4429,4430,4432,4433,90],{},"Put your images in one folder, named so they sort the way you want (",[456,4424,4425],{},"01.jpg",[456,4427,4428],{},"02.jpg"," and so on). Sorting is natural, so ",[456,4431,458],{}," comes before ",[456,4434,462],{},[36,4436,4437,4438,4440,4441,90],{},"Set ",[28,4439,1254],{}," to that folder and pick a ",[28,4442,1258],{},[36,4444,4437,4445,4447,4448,4450],{},[28,4446,3000],{}," to the shape of your objects, for example 2 : 3 for book covers, and ",[28,4449,3011],{}," to Fill (crop) if you do not want distortion.",[36,4452,1005,4453,4455],{},[28,4454,436],{},". The label shows \"Atlas: N images\".",[36,4457,4458,4459,4461],{},"Select the mesh objects and press ",[28,4460,468],{},". Objects are taken in name order and get image 1, 2, 3 and so on.",[17,4463,4464,4465,4162,4467,4469],{},"Objects need a UV map that fills the 0 to 1 square (a plane or an unwrapped cover does). If they have no UVs, open ",[28,4466,1763],{},[28,4468,3253],{}," to Front, Top or Side first.",[12,4471,4473],{"id":4472},"different-images-on-geometry-nodes-instances","Different images on Geometry Nodes instances",[17,4475,4476],{},"Use this for Instance on Points scatters and collection instances.",[980,4478,4479,4482,4489,4493,4496],{},[36,4480,4481],{},"Build the atlas as above.",[36,4483,4484,4485,4488],{},"Make the object that carries your Geometry Nodes modifier the ",[28,4486,4487],{},"active"," object. It must be a mesh.",[36,4490,1005,4491,90],{},[28,4492,474],{},[36,4494,4495],{},"Read the message at the bottom of Blender: it names the objects that received the material. These are the instanced source objects the add-on found through Object Info and Collection Info nodes, including nested groups.",[36,4497,4498],{},"If the message says no instanced source was found, select the source objects in addition to the host, keep the host active, and press the button again.",[17,4500,4501,4502,4504],{},"The add-on puts the ",[28,4503,478],{}," modifier last in the host's modifier stack. It stores an image index on every instance, and the material reads it.",[12,4506,4508],{"id":4507},"arrays-and-the-array-modifier","Arrays and the Array modifier",[980,4510,4511,4514,4517,4521,4524],{},[36,4512,4513],{},"Build the atlas.",[36,4515,4516],{},"Make the object with the Array modifier active.",[36,4518,1005,4519,90],{},[28,4520,474],{},[36,4522,4523],{},"If the array source is an object, it is found automatically. If not, select the source and press the button again.",[36,4525,4526,4527,4529,4530,4532,4533,4535],{},"To spread images differently, set ",[28,4528,484],{}," to ",[28,4531,1885],{},", change ",[28,4534,488],{},", and press the button again.",[17,4537,4538],{},"The modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.",[17,4540,4541],{},[94,4542],{"alt":4543,"src":4544},"Blender with 12 numbered instances, each showing its own image, and the Image Per Instance panel in the sidebar","\u002Fmedia\u002Fipi-panel-instances.jpg",[12,4546,4548],{"id":4547},"a-photo-wall-or-a-card-deck","A photo wall or a card deck",[980,4550,4551,4554,4562,4573,4577,4583,4593],{},[36,4552,4553],{},"Model one frame or card, with a UV map, as the source object. Give it extra material slots for edges or a frame if you like: only slot 1 receives the image.",[36,4555,4437,4556,4558,4559,4561],{},[28,4557,3000],{}," to the card shape (for example 2 : 3) and ",[28,4560,3011],{}," to Fill (crop) or Fit (bars).",[36,4563,4564,4565,4567,4568,4570,4571,90],{},"If you use Fit (bars), set ",[28,4566,3033],{},". To make the bars transparent, switch on ",[28,4569,3277],{}," under ",[28,4572,1763],{},[36,4574,1005,4575,90],{},[28,4576,436],{},[36,4578,4579,4580,4582],{},"Scatter or array the card, then press ",[28,4581,474],{}," on the host.",[36,4584,4585,4586,4570,4588,4590,4591,90],{},"For a screen wall, switch on ",[28,4587,3288],{},[28,4589,1763],{}," and raise ",[28,4592,3298],{},[36,4594,4595,4596,4529,4598,4600,4601,4603,4604,4606],{},"For a card deck where you want the images to look random, set ",[28,4597,484],{},[28,4599,1885],{},". Under ",[28,4602,1769],{},", add a little Hue or Brightness, and tick ",[28,4605,3412],{}," if mirrored images suit the look.",[12,4608,4610],{"id":4609},"putting-a-specific-image-on-a-specific-object","Putting a specific image on a specific object",[980,4612,4613,4615,4620,4625],{},[36,4614,4513],{},[36,4616,4617,4618,90],{},"Select one or more objects. Open ",[28,4619,1760],{},[36,4621,4622,4623,90],{},"Type a file name in the search field, or set ",[28,4624,3179],{},[36,4626,1005,4627,90],{},[28,4628,611],{},[17,4630,4631,4632,4634,4635,4637,4638,4640],{},"For many objects, name them after the files (an object ",[456,4633,517],{}," for ",[456,4636,521],{},"), select them all and press ",[28,4639,513],{},". The message tells you how many matched and lists the first few without a match.",[12,4642,4644],{"id":4643},"changing-the-images-later","Changing the images later",[980,4646,4647,4650,4655,4665,4676],{},[36,4648,4649],{},"Add, remove or rename images in the folder. Replace images by dropping new files in.",[36,4651,1005,4652,4654],{},[28,4653,436],{}," again. It replaces the atlas and keeps each object's picture by file name. If you removed files, objects that pointed past the end wrap around to a valid image.",[36,4656,4657,4658,305,4660,612,4662,4664],{},"Changes to ",[28,4659,1763],{},[28,4661,1766],{},[28,4663,1769],{}," apply immediately, with no second button.",[36,4666,4657,4667,674,4669,4671,4672,674,4674,90],{},[28,4668,488],{},[28,4670,484],{}," need another press of ",[28,4673,468],{},[28,4675,474],{},[36,4677,4678,4679,305,4681,305,4683,674,4685,4687,4688,4219],{},"To change ",[28,4680,1258],{},[28,4682,3000],{},[28,4684,3011],{},[28,4686,3046],{},", press ",[28,4689,436],{},[12,4691,4693],{"id":4692},"animating-through-the-images","Animating through the images",[980,4695,4696,4699,4706],{},[36,4697,4698],{},"Build the atlas and apply the images as usual.",[36,4700,1567,4701,4703,4704,90],{},[28,4702,1766],{},", tick the box in its header, and set ",[28,4705,3350],{},[36,4707,4708],{},"Play the timeline. Every object steps to the next image after that many frames, starting from its own image and wrapping around at the last one.",[12,4710,1126],{"id":1125},[33,4712,4713,4717,4721],{},[36,4714,1131,4715],{},[86,4716,715],{"href":716},[36,4718,4719],{},[86,4720,370],{"href":628},[36,4722,379,4723],{},[86,4724,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":4726},[4727,4728,4729,4730,4731,4732,4733,4734],{"id":4413,"depth":387,"text":4414},{"id":4472,"depth":387,"text":4473},{"id":4507,"depth":387,"text":4508},{"id":4547,"depth":387,"text":4548},{"id":4609,"depth":387,"text":4610},{"id":4643,"depth":387,"text":4644},{"id":4692,"depth":387,"text":4693},{"id":1125,"depth":387,"text":1126},"Step-by-step Image Per Instance recipes in Blender: separate objects, Geometry Nodes instances, arrays, photo walls, card decks and changing images later.",{},"---\ntitle: \"Image Per Instance workflows\"\ndescription: \"Step-by-step Image Per Instance recipes in Blender: separate objects, Geometry Nodes instances, arrays, photo walls, card decks and changing images later.\"\naddon: image-per-instance\norder: 4\nupdated: 2026-11-16\n---\n\nEvery recipe starts the same way: open the sidebar with **N** and go to the **Image Per Instance** tab. Names of controls are explained in the [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel).\n\n## Different images on separate objects\n\nUse this for frames on a wall, book covers or cards that are individual objects.\n\n1. Put your images in one folder, named so they sort the way you want (`01.jpg`, `02.jpg` and so on). Sorting is natural, so `img2` comes before `img10`.\n2. Set **Image Folder** to that folder and pick a **Tile Size**.\n3. Set **Tile Shape** to the shape of your objects, for example 2 : 3 for book covers, and **Fit** to Fill (crop) if you do not want distortion.\n4. Press **Build Atlas**. The label shows \"Atlas: N images\".\n5. Select the mesh objects and press **Apply To Selected Objects**. Objects are taken in name order and get image 1, 2, 3 and so on.\n\nObjects need a UV map that fills the 0 to 1 square (a plane or an unwrapped cover does). If they have no UVs, open **Material** and set **Mapping** to Front, Top or Side first.\n\n## Different images on Geometry Nodes instances\n\nUse this for Instance on Points scatters and collection instances.\n\n1. Build the atlas as above.\n2. Make the object that carries your Geometry Nodes modifier the **active** object. It must be a mesh.\n3. Press **Add To Instances (Geometry Nodes)**.\n4. Read the message at the bottom of Blender: it names the objects that received the material. These are the instanced source objects the add-on found through Object Info and Collection Info nodes, including nested groups.\n5. If the message says no instanced source was found, select the source objects in addition to the host, keep the host active, and press the button again.\n\nThe add-on puts the **IPI Assign Index** modifier last in the host's modifier stack. It stores an image index on every instance, and the material reads it.\n\n## Arrays and the Array modifier\n\n1. Build the atlas.\n2. Make the object with the Array modifier active.\n3. Press **Add To Instances (Geometry Nodes)**.\n4. If the array source is an object, it is found automatically. If not, select the source and press the button again.\n5. To spread images differently, set **Order** to **Shuffle**, change **Seed**, and press the button again.\n\nThe modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.\n\n![Blender with 12 numbered instances, each showing its own image, and the Image Per Instance panel in the sidebar](\u002Fmedia\u002Fipi-panel-instances.jpg)\n\n## A photo wall or a card deck\n\n1. Model one frame or card, with a UV map, as the source object. Give it extra material slots for edges or a frame if you like: only slot 1 receives the image.\n2. Set **Tile Shape** to the card shape (for example 2 : 3) and **Fit** to Fill (crop) or Fit (bars).\n3. If you use Fit (bars), set **Bar Colour**. To make the bars transparent, switch on **Use Image Alpha** under **Material**.\n4. Press **Build Atlas**.\n5. Scatter or array the card, then press **Add To Instances (Geometry Nodes)** on the host.\n6. For a screen wall, switch on **Emissive (screen)** under **Material** and raise **Strength**.\n7. For a card deck where you want the images to look random, set **Order** to **Shuffle**. Under **Random Variation**, add a little Hue or Brightness, and tick **Flip X** if mirrored images suit the look.\n\n## Putting a specific image on a specific object\n\n1. Build the atlas.\n2. Select one or more objects. Open **Choose Images Yourself**.\n3. Type a file name in the search field, or set **Image Number**.\n4. Press **Assign Image To Selected**.\n\nFor many objects, name them after the files (an object `poster_cat` for `cat.png`), select them all and press **Match By Object Name**. The message tells you how many matched and lists the first few without a match.\n\n## Changing the images later\n\n1. Add, remove or rename images in the folder. Replace images by dropping new files in.\n2. Press **Build Atlas** again. It replaces the atlas and keeps each object's picture by file name. If you removed files, objects that pointed past the end wrap around to a valid image.\n3. Changes to **Material**, **Animate** and **Random Variation** apply immediately, with no second button.\n4. Changes to **Seed** or **Order** need another press of **Apply To Selected Objects** or **Add To Instances (Geometry Nodes)**.\n5. To change **Tile Size**, **Tile Shape**, **Fit** or **Padding**, press **Build Atlas** again.\n\n## Animating through the images\n\n1. Build the atlas and apply the images as usual.\n2. Open **Animate**, tick the box in its header, and set **Frames Per Image**.\n3. Play the timeline. Every object steps to the next image after that many frames, starting from its own image and wrapping around at the last one.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":4397,"description":4735},"docs\u002Fimage-per-instance\u002Fworkflows","WuHQgMIbTwtxhYNSMzs4I0ljgQEoZvBeUboCTFs0Kn0",{"id":4742,"title":4743,"addon":1325,"body":4744,"description":5074,"extension":403,"meta":5075,"navigation":408,"order":4390,"path":796,"rawbody":5076,"seo":5077,"stem":5078,"updated":417,"__hash__":5079},"docs\u002Fdocs\u002Fquadfix\u002Fworkflows.md","QuadFix workflows: step-by-step recipes",{"type":9,"value":4745,"toc":5065},[4746,4763,4767,4770,4804,4810,4816,4824,4828,4831,4874,4879,4883,4886,4923,4929,4935,4941,4945,4948,4985,4993,4997,5000,5033,5036,5040,5045,5047],[17,4747,4748,4749,4751,4752,4754,4755,4757,4758,1408,4760,4762],{},"Each workflow uses the tools exactly as they are named in the ",[28,4750,747],{}," sidebar tab. Open it with ",[456,4753,1378],{},". The options are explained in the ",[86,4756,89],{"href":792},". After every step, read the result line at the bottom of the panel, and use ",[456,4759,1407],{},[456,4761,1411],{}," on Mac) if you do not like the result.",[12,4764,4766],{"id":4765},"close-holes-with-fill-holes-with-quads","Close holes with Fill Holes with Quads",[17,4768,4769],{},"Use this for deleted faces, scan gaps and openings in imported meshes.",[980,4771,4772,4777,4782,4785,4794,4798],{},[36,4773,4774,4775,1389],{},"Select the mesh and press ",[456,4776,1388],{},[36,4778,1005,4779,4781],{},[28,4780,779],{},". Boundary edges are selected and the panel shows how many there are.",[36,4783,4784],{},"Reduce the selection to the holes you want to close. Fill Holes only closes a hole when its whole boundary loop is selected, so a half-selected hole is skipped. Be careful: every fully selected closed loop is filled, including openings that are meant to be open.",[36,4786,4787,4788,4790,4791,4793],{},"Leave ",[28,4789,1417],{}," on. Leave ",[28,4792,3675],{}," at 0 for an automatic choice.",[36,4795,1005,4796,90],{},[28,4797,755],{},[36,4799,4800,4801,90],{},"Read the result, for example ",[456,4802,4803],{},"Filled 3 loop(s). Now: ... quads \u002F ... tris \u002F ... n-gons",[17,4805,4806],{},[94,4807],{"alt":4808,"src":4809},"Blender sphere with large holes in the surface, shown before the Fill Holes with Quads step","\u002Fmedia\u002Fquadfix-holes-sphere-before.jpg",[17,4811,4812],{},[94,4813],{"alt":4814,"src":4815},"The same sphere after Fill Holes with Quads: the holes are closed with a continuous quad grid","\u002Fmedia\u002Fquadfix-holes-sphere-after.jpg",[17,4817,4818,4819,4821,4822,90],{},"If the mesh around the hole is made of triangles, the patch is triangulated as well so it matches. To get quads anyway, untick ",[28,4820,3686],{}," and run it again from undo. For the manual way to do this in Blender, read ",[86,4823,1464],{"href":858},[12,4825,4827],{"id":4826},"bridge-two-edge-loops","Bridge two edge loops",[17,4829,4830],{},"Use this to connect two openings, or two open chains of edges, when they have different numbers of edges.",[980,4832,4833,4841,4852,4855,4859,4871],{},[36,4834,1005,4835,4837,4838,340],{},[456,4836,1388],{}," for Edit Mode and switch to Edge select mode (press ",[456,4839,4840],{},"2",[36,4842,4843,4844,4847,4848,4851],{},"Select the first loop with ",[456,4845,4846],{},"Alt"," and click, then add the second one with ",[456,4849,4850],{},"Shift+Alt"," and click. Both sides must be open (boundary) edges.",[36,4853,4854],{},"Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.",[36,4856,1005,4857,90],{},[28,4858,761],{},[36,4860,4861,4862,4864,4865,4867,4868,4870],{},"Open the Adjust Last Operation panel. Leave ",[28,4863,3746],{}," on for roughly square quads, or switch it off and set ",[28,4866,2542],{},". Raise ",[28,4869,3766],{}," if the two sides are tilted against each other and you want the strip to follow the surface.",[36,4872,4873],{},"The new strip is selected. The report says how many quads, rows and reductions were made.",[17,4875,4876,4877,90],{},"If the total number of edges on the two sides is odd, one triangle remains and the report says so. If the tool refuses, it selects the edges that caused the problem and tells you why. See ",[86,4878,629],{"href":835},[12,4880,4882],{"id":4881},"clean-up-after-a-boolean-or-an-import","Clean up after a Boolean or an import",[17,4884,4885],{},"Use this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.",[980,4887,4888,4891,4899,4905,4911,4916,4920],{},[36,4889,4890],{},"Apply the Boolean modifier if it is still a modifier.",[36,4892,1005,4893,4895,4896,4898],{},[456,4894,1388],{}," and then ",[28,4897,779],{}," to see the state of the mesh. Note the counts.",[36,4900,4901,4902,4904],{},"Select the whole mesh with ",[456,4903,1400],{},", or select only the area around the cut.",[36,4906,4907,4908,4910],{},"Check ",[28,4909,3920],{},". The default 0.0001 suits objects of ordinary size. Raise it if doubles survive on a large model, lower it on a very small one.",[36,4912,4787,4913,4915],{},[28,4914,3942],{}," on if you have marked sharp edges or seams that must survive.",[36,4917,1005,4918,90],{},[28,4919,773],{},[36,4921,4922],{},"Read the result: vertex count, then quads, triangles and n-gons before and after.",[17,4924,4925],{},[94,4926],{"alt":4927,"src":4928},"Cube with a Boolean cut, triangles and n-gons around the cut, before Clean and Quad","\u002Fmedia\u002Fquadfix-boolean-cleanup-before.jpg",[17,4930,4931],{},[94,4932],{"alt":4933,"src":4934},"The same cube after Clean & Quad: clean quads around the cut","\u002Fmedia\u002Fquadfix-boolean-cleanup-after.jpg",[17,4936,832,4937,4940],{},[86,4938,4939],{"href":872},"guide to cleaning up an imported STL"," goes through the same steps on a full import.",[12,4942,4944],{"id":4943},"convert-triangles-and-n-gons-to-quads","Convert triangles and n-gons to quads",[17,4946,4947],{},"Use this on triangulated scans, imported meshes or n-gons you want to subdivide.",[980,4949,4950,4956,4961,4967,4971],{},[36,4951,4952,4953,4955],{},"In Edit Mode, press ",[28,4954,779],{}," to see how many triangles and n-gons there are.",[36,4957,4958,4959,90],{},"Select the faces to convert, or press ",[456,4960,1400],{},[36,4962,4963,4964,4966],{},"Decide about flat n-gons. ",[28,4965,3858],{}," is on by default and leaves them alone, which is right for CAD surfaces and flat caps. Switch it off for scans.",[36,4968,1005,4969,90],{},[28,4970,767],{},[36,4972,4973,4974,4976,4977,4979,4980,612,4982,4984],{},"Look at the result, for example ",[456,4975,3884],{},". For fewer triangles, switch on ",[28,4978,3868],{}," or raise ",[28,4981,3837],{},[28,4983,3848],{},", undo, and run it again. For more regular quads, lower them.",[17,4986,4987,4988,4990,4991,90],{},"Faces that are still triangles after the run are triangles QuadFix could not pair without breaking the limits you set. Select them with ",[28,4989,779],{},". More detail in ",[86,4992,1467],{"href":865},[12,4994,4996],{"id":4995},"union-meshes-with-a-clean-seam","Union meshes with a clean seam",[17,4998,4999],{},"Use this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.",[980,5001,5002,5005,5012,5021,5024],{},[36,5003,5004],{},"In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.",[36,5006,4303,5007,5009,5010,90],{},[28,5008,3557],{}," panel, press ",[28,5011,785],{},[36,5013,5014,5015,5017,5018,5020],{},"Open Adjust Last Operation. Leave ",[28,5016,4006],{}," on Auto unless a seam came out badly. Raise ",[28,5019,4017],{}," only if the report says seams were left as a plain Boolean and you accept a larger shape change.",[36,5022,5023],{},"Read the result: how many seam loops were rebuilt and how many were left as a plain Boolean, plus the quad, triangle and n-gon counts.",[36,5025,5026,5027,5029,5030,5032],{},"The other objects are hidden. Use ",[28,5028,4049],{}," to bring them back, or switch off ",[28,5031,4028],{}," to delete them.",[17,5034,5035],{},"Both meshes should be closed and should overlap. If they do not intersect, nothing is changed and you get a warning. UVs are not generated for the new strip.",[12,5037,5039],{"id":5038},"check-your-work","Check your work",[17,5041,1005,5042,5044],{},[28,5043,779],{}," at the end. The footer shows the remaining non-quad faces and boundary edges. For an open mesh such as a plane, the outer rim always counts as boundary edges.",[12,5046,1126],{"id":1125},[33,5048,5049,5053,5057],{},[36,5050,1131,5051],{},[86,5052,747],{"href":949},[36,5054,5055],{},[86,5056,370],{"href":835},[36,5058,1461,5059,305,5061,612,5063],{},[86,5060,1464],{"href":858},[86,5062,1467],{"href":865},[86,5064,1470],{"href":872},{"title":386,"searchDepth":387,"depth":387,"links":5066},[5067,5068,5069,5070,5071,5072,5073],{"id":4765,"depth":387,"text":4766},{"id":4826,"depth":387,"text":4827},{"id":4881,"depth":387,"text":4882},{"id":4943,"depth":387,"text":4944},{"id":4995,"depth":387,"text":4996},{"id":5038,"depth":387,"text":5039},{"id":1125,"depth":387,"text":1126},"Step-by-step QuadFix workflows in Blender: fill a hole with quads, bridge two edge loops, clean up after a Boolean, convert n-gons and union meshes.",{},"---\ntitle: \"QuadFix workflows: step-by-step recipes\"\ndescription: \"Step-by-step QuadFix workflows in Blender: fill a hole with quads, bridge two edge loops, clean up after a Boolean, convert n-gons and union meshes.\"\naddon: quadfix\norder: 4\nupdated: 2026-11-16\n---\n\nEach workflow uses the tools exactly as they are named in the **QuadFix** sidebar tab. Open it with `N`. The options are explained in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel). After every step, read the result line at the bottom of the panel, and use `Ctrl+Z` (`Cmd+Z` on Mac) if you do not like the result.\n\n## Close holes with Fill Holes with Quads\n\nUse this for deleted faces, scan gaps and openings in imported meshes.\n\n1. Select the mesh and press `Tab` for Edit Mode.\n2. Press **Select Non-Quads & Holes**. Boundary edges are selected and the panel shows how many there are.\n3. Reduce the selection to the holes you want to close. Fill Holes only closes a hole when its whole boundary loop is selected, so a half-selected hole is skipped. Be careful: every fully selected closed loop is filled, including openings that are meant to be open.\n4. Leave **Only Selected** on. Leave **Grid Span** at 0 for an automatic choice.\n5. Press **Fill Holes with Quads**.\n6. Read the result, for example `Filled 3 loop(s). Now: ... quads \u002F ... tris \u002F ... n-gons`.\n\n![Blender sphere with large holes in the surface, shown before the Fill Holes with Quads step](\u002Fmedia\u002Fquadfix-holes-sphere-before.jpg)\n\n![The same sphere after Fill Holes with Quads: the holes are closed with a continuous quad grid](\u002Fmedia\u002Fquadfix-holes-sphere-after.jpg)\n\nIf the mesh around the hole is made of triangles, the patch is triangulated as well so it matches. To get quads anyway, untick **Match Triangle Meshes** and run it again from undo. For the manual way to do this in Blender, read [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads).\n\n## Bridge two edge loops\n\nUse this to connect two openings, or two open chains of edges, when they have different numbers of edges.\n\n1. Press `Tab` for Edit Mode and switch to Edge select mode (press `2`).\n2. Select the first loop with `Alt` and click, then add the second one with `Shift+Alt` and click. Both sides must be open (boundary) edges.\n3. Check the sides: both closed loops, or both open chains. The edge counts may differ by up to 4 to 1.\n4. Press **Bridge to Quads**.\n5. Open the Adjust Last Operation panel. Leave **Auto Cuts** on for roughly square quads, or switch it off and set **Cuts**. Raise **Smoothness** if the two sides are tilted against each other and you want the strip to follow the surface.\n6. The new strip is selected. The report says how many quads, rows and reductions were made.\n\nIf the total number of edges on the two sides is odd, one triangle remains and the report says so. If the tool refuses, it selects the edges that caused the problem and tells you why. See [troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting).\n\n## Clean up after a Boolean or an import\n\nUse this after a Boolean modifier is applied, or after importing an STL, OBJ, FBX or CAD mesh.\n\n1. Apply the Boolean modifier if it is still a modifier.\n2. Press `Tab` and then **Select Non-Quads & Holes** to see the state of the mesh. Note the counts.\n3. Select the whole mesh with `A`, or select only the area around the cut.\n4. Check **Merge Distance**. The default 0.0001 suits objects of ordinary size. Raise it if doubles survive on a large model, lower it on a very small one.\n5. Leave **Keep Sharp Edges** on if you have marked sharp edges or seams that must survive.\n6. Press **Clean & Quad (Boolean Prep)**.\n7. Read the result: vertex count, then quads, triangles and n-gons before and after.\n\n![Cube with a Boolean cut, triangles and n-gons around the cut, before Clean and Quad](\u002Fmedia\u002Fquadfix-boolean-cleanup-before.jpg)\n\n![The same cube after Clean & Quad: clean quads around the cut](\u002Fmedia\u002Fquadfix-boolean-cleanup-after.jpg)\n\nThe [guide to cleaning up an imported STL](\u002Fguides\u002Fclean-up-imported-stl) goes through the same steps on a full import.\n\n## Convert triangles and n-gons to quads\n\nUse this on triangulated scans, imported meshes or n-gons you want to subdivide.\n\n1. In Edit Mode, press **Select Non-Quads & Holes** to see how many triangles and n-gons there are.\n2. Select the faces to convert, or press `A`.\n3. Decide about flat n-gons. **Keep Planar N-gons** is on by default and leaves them alone, which is right for CAD surfaces and flat caps. Switch it off for scans.\n4. Press **N-gons to Quads**.\n5. Look at the result, for example `n-gons 4→0, tris 120→8, quads 300→412`. For fewer triangles, switch on **Aggressive Quads** or raise **Face Angle** and **Shape Angle**, undo, and run it again. For more regular quads, lower them.\n\nFaces that are still triangles after the run are triangles QuadFix could not pair without breaking the limits you set. Select them with **Select Non-Quads & Holes**. More detail in [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads).\n\n## Union meshes with a clean seam\n\nUse this to merge overlapping closed objects, for example a sphere and a cylinder, without a ragged Boolean seam.\n\n1. In Object Mode, select the objects to merge. Click the object you want to keep last, so it is the active one.\n2. In the **Union (Object Mode)** panel, press **Union to Quads**.\n3. Open Adjust Last Operation. Leave **Rings** on Auto unless a seam came out badly. Raise **Max Shape Change %** only if the report says seams were left as a plain Boolean and you accept a larger shape change.\n4. Read the result: how many seam loops were rebuilt and how many were left as a plain Boolean, plus the quad, triangle and n-gon counts.\n5. The other objects are hidden. Use **Object > Show\u002FHide > Reveal Hidden** to bring them back, or switch off **Keep Originals Hidden** to delete them.\n\nBoth meshes should be closed and should overlap. If they do not intersect, nothing is changed and you get a warning. UVs are not generated for the new strip.\n\n## Check your work\n\nPress **Select Non-Quads & Holes** at the end. The footer shows the remaining non-quad faces and boundary edges. For an open mesh such as a plane, the outer rim always counts as boundary edges.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":4743,"description":5074},"docs\u002Fquadfix\u002Fworkflows","01JysYD94Vx69fa0CdP2RxmGBDfrWl54m9_aAqZFo5A",{"id":5081,"title":5082,"addon":962,"body":5083,"description":5297,"extension":403,"meta":5298,"navigation":408,"order":5299,"path":369,"rawbody":5300,"seo":5301,"stem":5302,"updated":417,"__hash__":5303},"docs\u002Fdocs\u002Fbedsplit\u002Ftroubleshooting.md","BedSplit troubleshooting",{"type":9,"value":5084,"toc":5279},[5085,5089,5107,5111,5120,5124,5130,5134,5137,5147,5152,5156,5159,5163,5169,5173,5176,5180,5183,5202,5206,5209,5213,5219,5223,5231,5235,5238,5242,5245,5249,5255,5259,5262,5264],[12,5086,5088],{"id":5087},"the-bedsplit-tab-is-missing","The BedSplit tab is missing",[17,5090,5091,5092,5094,5095,5097,5098,5100,5101,5103,5104,90],{},"The panels show only in Object Mode and in a 3D Viewport sidebar. Press ",[28,5093,1378],{},", leave Edit Mode, and look for the ",[28,5096,407],{}," tab. If you installed BedSplit Lite, its tab is named ",[28,5099,1121],{},". If neither is there, check ",[28,5102,1509],{}," that the extension is enabled. See ",[86,5105,5106],{"href":294},"install",[12,5108,5110],{"id":5109},"the-buttons-are-greyed-out","The buttons are greyed out",[17,5112,5113,305,5115,612,5117,5119],{},[28,5114,50],{},[28,5116,1096],{},[28,5118,30],{}," need Object Mode and a mesh. A mesh imported from glTF often has an empty parent that becomes active. BedSplit then uses the only selected mesh, or the only mesh below the active object. If several meshes are selected, select just one, or join them first.",[12,5121,5123],{"id":5122},"the-model-has-holes-or-is-not-manifold-do-i-need-to-fix-it-first","The model has holes or is not manifold. Do I need to fix it first?",[17,5125,5126,5127,5129],{},"No. The split repairs holes, flipped normals, loose edges and overlapping shells before cutting, and the ",[28,5128,1011],{}," panel tells you what it did. If the mesh was too damaged for a light repair, the surface is rebuilt, and the panel warns \"Heavy repair: surface rebuilt, fine detail smoothed\" when the surface moved by more than 0.5 mm. In that case compare the parts to the original and fix the damaged area by hand if you lose detail you need.",[12,5131,5133],{"id":5132},"it-says-the-model-is-mm-long-and-needs-about-parts-turn-on-resize-for-print","It says \"The model is ... mm long and needs about ... parts. Turn on Resize for print\"",[17,5135,5136],{},"This is the scale check. If the whole model would need more than 64 parts at your bed size, BedSplit stops before cutting anything. The parts are counted as the product of the slabs per axis, so a model that is five bed-widths wide, deep and tall already needs 125. A count that high nearly always means the units are wrong, for example a model in metres read as millimetres, or the reverse. Fix it one of two ways:",[980,5138,5139,5144],{},[36,5140,5141,5142,996],{},"Turn on ",[28,5143,190],{},[36,5145,5146],{},"Correct the scene unit scale so the \"Now: ... mm longest side\" line shows the real size.",[17,5148,5149,5150,90],{},"The same message appears from ",[28,5151,50],{},[12,5153,5155],{"id":5154},"the-message-says-the-object-has-no-faces-or-the-object-has-no-size","The message says \"The object has no faces\" or \"The object has no size\"",[17,5157,5158],{},"The selected object is empty, or every vertex is at the same place, or modifiers produce nothing. Check that the object shows a mesh in the viewport.",[12,5160,5162],{"id":5161},"n-parts-larger-than-the-bed-add-a-cut-plane","\"N part(s) larger than the bed: add a cut plane\"",[17,5164,5165,5166,5168],{},"At least one part exceeds the bed on some axis. This most often happens with a hand-made cut list that leaves a piece wider than the bed. Press ",[28,5167,4207],{}," on the axis that is too long, or move a plane so pieces are smaller, then split again. Remember that the printer's height counts too: a piece must fit the print height as well as the width and depth.",[12,5170,5172],{"id":5171},"n-parts-not-watertight-move-a-cut-plane-and-split-again","\"N part(s) not watertight: move a cut plane and split again\"",[17,5174,5175],{},"A cut produced a part the add-on could not close. BedSplit already retries up to five times with the planes nudged by a fraction of a millimetre. If it still fails, slide a plane a few millimetres and split again.",[12,5177,5179],{"id":5178},"some-joints-have-no-dowel","Some joints have no dowel",[17,5181,5182],{},"The message \"N joint(s) without dowel (wall too thin): glue these\" means the cut face is too small or too thin. A socket needs 1.6 mm of wall around it in both parts, so with the default 6 mm dowel and 0.2 mm clearance the section must be about 10 mm across. Options:",[33,5184,5185,5188,5194,5199],{},[36,5186,5187],{},"Move the cut to a thicker place.",[36,5189,5190,5191,5193],{},"Lower ",[28,5192,2665],{},", which lowers the needed wall.",[36,5195,4437,5196,5198],{},[28,5197,2698],{}," to 1.",[36,5200,5201],{},"Accept it and glue the flat faces.",[12,5203,5205],{"id":5204},"a-dowel-socket-came-out-wrong-check-the-joints","\"A dowel socket came out wrong: check the joints\"",[17,5207,5208],{},"The built-in check found a socket that either overlaps the dowel or whose gap differs from the clearance. Look at the joints in the viewport, and slide the cut or change the dowel diameter and split again.",[12,5210,5212],{"id":5211},"the-dowels-are-too-tight-or-too-loose","The dowels are too tight, or too loose",[17,5214,5215,5216,5218],{},"The socket is made as wide as the dowel plus the ",[28,5217,2687],{}," on every side. Printers over- or under-extrude, so the same 0.2 mm can behave differently. Print one test joint. If tight, raise the clearance in steps (0.25, 0.3). Re-split to apply it. The range is 0 to 1 mm.",[12,5220,5222],{"id":5221},"split-failed-move-a-cut-plane-and-try-again","\"Split failed ... Move a cut plane and try again\"",[17,5224,5225,5226,5228,5229,90],{},"An unexpected error occurred during cutting. Move a plane a little with ",[28,5227,50],{}," and try again. If it keeps happening on a particular model, send it with your Blender version via the ",[86,5230,328],{"href":327},[12,5232,5234],{"id":5233},"the-result-looks-wrong-or-i-want-to-start-over","The result looks wrong or I want to start over",[17,5236,5237],{},"The split does not change the source. Delete the collection called \"BedSplit - \" plus your model name, or press Undo, or just split again, which replaces the previous result for that source.",[12,5239,5241],{"id":5240},"the-stl-files-do-not-match-my-slicer-scale","The STL files do not match my slicer scale",[17,5243,5244],{},"The files are exported in millimetres. Import them at 100 percent. If your slicer assumes inches, change that setting there.",[12,5246,5248],{"id":5247},"export-stl-is-greyed-out-or-it-says-choose-a-folder","Export STL is greyed out, or it says \"choose a folder\"",[17,5250,5251,5252,5254],{},"The button needs a result in the scene. Run ",[28,5253,30],{}," first. When the folder chooser is closed with no folder, you get \"choose a folder\". If the folder cannot be written the message says \"cannot write the files\".",[12,5256,5258],{"id":5257},"splitting-is-slow","Splitting is slow",[17,5260,5261],{},"Cutting and repair run in Blender's Python, so a mesh with millions of faces keeps Blender busy for a while, and the cursor shows a wait symbol until the result appears. A typical figure finishes in seconds. The slowest case is a broken mesh that needs the voxel rebuild: the add-on tries a fine 0.8 mm grid first and steps up to coarser grids (1.15, 1.6, 2.4, then 3.2 mm) when the rebuilt surface would exceed 600,000 faces. If the wait is long, reduce the polygon count first, for example with a Decimate modifier applied to a copy.",[12,5263,1126],{"id":1125},[33,5265,5266,5270,5275],{},[36,5267,1131,5268],{},[86,5269,407],{"href":409},[36,5271,5272,5274],{},[86,5273,358],{"href":88}," for defaults and ranges",[36,5276,379,5277],{},[86,5278,383],{"href":382},{"title":386,"searchDepth":387,"depth":387,"links":5280},[5281,5282,5283,5284,5285,5286,5287,5288,5289,5290,5291,5292,5293,5294,5295,5296],{"id":5087,"depth":387,"text":5088},{"id":5109,"depth":387,"text":5110},{"id":5122,"depth":387,"text":5123},{"id":5132,"depth":387,"text":5133},{"id":5154,"depth":387,"text":5155},{"id":5161,"depth":387,"text":5162},{"id":5171,"depth":387,"text":5172},{"id":5178,"depth":387,"text":5179},{"id":5204,"depth":387,"text":5205},{"id":5211,"depth":387,"text":5212},{"id":5221,"depth":387,"text":5222},{"id":5233,"depth":387,"text":5234},{"id":5240,"depth":387,"text":5241},{"id":5247,"depth":387,"text":5248},{"id":5257,"depth":387,"text":5258},{"id":1125,"depth":387,"text":1126},"Fix common BedSplit problems: non-manifold or broken meshes, wrong scale or units, parts still larger than the bed, dowels missing in thin walls, tight dowels.",{},8,"---\ntitle: \"BedSplit troubleshooting\"\ndescription: \"Fix common BedSplit problems: non-manifold or broken meshes, wrong scale or units, parts still larger than the bed, dowels missing in thin walls, tight dowels.\"\naddon: bedsplit\norder: 8\nupdated: 2026-11-16\n---\n\n## The BedSplit tab is missing\n\nThe panels show only in Object Mode and in a 3D Viewport sidebar. Press **N**, leave Edit Mode, and look for the **BedSplit** tab. If you installed BedSplit Lite, its tab is named **BedSplit Lite**. If neither is there, check **Edit > Preferences > Get Extensions** that the extension is enabled. See [install](\u002Fdocs\u002Fbedsplit\u002Finstall).\n\n## The buttons are greyed out\n\n**Find Cuts**, **Add Cut** and **Split to Bed** need Object Mode and a mesh. A mesh imported from glTF often has an empty parent that becomes active. BedSplit then uses the only selected mesh, or the only mesh below the active object. If several meshes are selected, select just one, or join them first.\n\n## The model has holes or is not manifold. Do I need to fix it first?\n\nNo. The split repairs holes, flipped normals, loose edges and overlapping shells before cutting, and the **Result** panel tells you what it did. If the mesh was too damaged for a light repair, the surface is rebuilt, and the panel warns \"Heavy repair: surface rebuilt, fine detail smoothed\" when the surface moved by more than 0.5 mm. In that case compare the parts to the original and fix the damaged area by hand if you lose detail you need.\n\n## It says \"The model is ... mm long and needs about ... parts. Turn on Resize for print\"\n\nThis is the scale check. If the whole model would need more than 64 parts at your bed size, BedSplit stops before cutting anything. The parts are counted as the product of the slabs per axis, so a model that is five bed-widths wide, deep and tall already needs 125. A count that high nearly always means the units are wrong, for example a model in metres read as millimetres, or the reverse. Fix it one of two ways:\n\n1. Turn on **Resize for print** and type the real longest side in millimetres.\n2. Correct the scene unit scale so the \"Now: ... mm longest side\" line shows the real size.\n\nThe same message appears from **Find Cuts**.\n\n## The message says \"The object has no faces\" or \"The object has no size\"\n\nThe selected object is empty, or every vertex is at the same place, or modifiers produce nothing. Check that the object shows a mesh in the viewport.\n\n## \"N part(s) larger than the bed: add a cut plane\"\n\nAt least one part exceeds the bed on some axis. This most often happens with a hand-made cut list that leaves a piece wider than the bed. Press **Add cut** on the axis that is too long, or move a plane so pieces are smaller, then split again. Remember that the printer's height counts too: a piece must fit the print height as well as the width and depth.\n\n## \"N part(s) not watertight: move a cut plane and split again\"\n\nA cut produced a part the add-on could not close. BedSplit already retries up to five times with the planes nudged by a fraction of a millimetre. If it still fails, slide a plane a few millimetres and split again.\n\n## Some joints have no dowel\n\nThe message \"N joint(s) without dowel (wall too thin): glue these\" means the cut face is too small or too thin. A socket needs 1.6 mm of wall around it in both parts, so with the default 6 mm dowel and 0.2 mm clearance the section must be about 10 mm across. Options:\n\n- Move the cut to a thicker place.\n- Lower **Dowel diameter, mm**, which lowers the needed wall.\n- Set **Dowels per joint** to 1.\n- Accept it and glue the flat faces.\n\n## \"A dowel socket came out wrong: check the joints\"\n\nThe built-in check found a socket that either overlaps the dowel or whose gap differs from the clearance. Look at the joints in the viewport, and slide the cut or change the dowel diameter and split again.\n\n## The dowels are too tight, or too loose\n\nThe socket is made as wide as the dowel plus the **Clearance, mm** on every side. Printers over- or under-extrude, so the same 0.2 mm can behave differently. Print one test joint. If tight, raise the clearance in steps (0.25, 0.3). Re-split to apply it. The range is 0 to 1 mm.\n\n## \"Split failed ... Move a cut plane and try again\"\n\nAn unexpected error occurred during cutting. Move a plane a little with **Find Cuts** and try again. If it keeps happening on a particular model, send it with your Blender version via the [contact page](\u002Fcontact).\n\n## The result looks wrong or I want to start over\n\nThe split does not change the source. Delete the collection called \"BedSplit - \" plus your model name, or press Undo, or just split again, which replaces the previous result for that source.\n\n## The STL files do not match my slicer scale\n\nThe files are exported in millimetres. Import them at 100 percent. If your slicer assumes inches, change that setting there.\n\n## Export STL is greyed out, or it says \"choose a folder\"\n\nThe button needs a result in the scene. Run **Split to Bed** first. When the folder chooser is closed with no folder, you get \"choose a folder\". If the folder cannot be written the message says \"cannot write the files\".\n\n## Splitting is slow\n\nCutting and repair run in Blender's Python, so a mesh with millions of faces keeps Blender busy for a while, and the cursor shows a wait symbol until the result appears. A typical figure finishes in seconds. The slowest case is a broken mesh that needs the voxel rebuild: the add-on tries a fine 0.8 mm grid first and steps up to coarser grids (1.15, 1.6, 2.4, then 3.2 mm) when the rebuilt surface would exceed 600,000 faces. If the wait is long, reduce the polygon count first, for example with a Decimate modifier applied to a copy.\n\n## Related\n\n- Product page: [BedSplit](\u002Faddons\u002Fbedsplit)\n- [Panel reference](\u002Fdocs\u002Fbedsplit\u002Fpanel) for defaults and ranges\n- Guide: [how to split a model for 3D printing](\u002Fguides\u002Fsplit-model-for-3d-printing)\n",{"title":5082,"description":5297},"docs\u002Fbedsplit\u002Ftroubleshooting","RTt9TbtnZgQuUULAfn-uldoCFdczAhtPyqVQnvZW-W0",{"id":5305,"title":5306,"addon":1164,"body":5307,"description":5541,"extension":403,"meta":5542,"navigation":408,"order":5299,"path":628,"rawbody":5543,"seo":5544,"stem":5545,"updated":417,"__hash__":5546},"docs\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting.md","Image Per Instance troubleshooting",{"type":9,"value":5308,"toc":5519},[5309,5315,5319,5327,5331,5334,5338,5347,5351,5354,5358,5364,5368,5382,5386,5389,5393,5401,5405,5408,5412,5417,5421,5424,5428,5434,5438,5441,5445,5451,5455,5463,5467,5470,5474,5484,5488,5496,5500,5503,5505],[17,5310,5311,5312,5314],{},"Each answer below uses the message text the add-on shows at the bottom of Blender. If your problem is not here, write to ",[86,5313,912],{"href":911}," with your Blender version and the add-on version shown at the bottom of the panel.",[12,5316,5318],{"id":5317},"what-does-choose-an-image-folder-first-mean","What does \"Choose an image folder first\" mean?",[17,5320,5321,5323,5324,5326],{},[28,5322,436],{}," was pressed while ",[28,5325,1254],{}," is empty. Click the folder icon next to Image Folder and choose a folder.",[12,5328,5330],{"id":5329},"why-does-blender-say-no-images-found-in-my-folder","Why does Blender say \"No images found\" in my folder?",[17,5332,5333],{},"The folder exists but holds no supported files directly inside it. Supported types are png, jpg, jpeg, tif, tiff, bmp, webp, exr and tga. Subfolders are not searched, so move the images up one level or point to the subfolder. The message includes the folder path it looked in, so check it for typos.",[12,5335,5337],{"id":5336},"what-if-the-atlas-is-too-big-limit-16384","What if the atlas is too big (limit 16384)?",[17,5339,5340,5341,5343,5344,5346],{},"The message reads \"Atlas would be W x H px (limit 16384). Use a smaller tile size or fewer images\". The atlas can be at most 16384 px on each side. 256 images at 1024 px fit exactly. 257 do not. Lower ",[28,5342,1258],{},", or use fewer images. A non-square ",[28,5345,3000],{}," changes the sizes too.",[12,5348,5350],{"id":5349},"why-does-the-lite-version-say-this-free-version-supports-up-to-20-images","Why does the Lite version say \"This free version supports up to 20 images\"?",[17,5352,5353],{},"Lite builds atlases of up to 20 images. Move extra files out of the folder, or use the full version, which has no image limit in the add-on.",[12,5355,5357],{"id":5356},"why-are-some-images-black-or-missing-in-the-atlas","Why are some images black or missing in the atlas?",[17,5359,5360,5361,5363],{},"If a file cannot be read, ",[28,5362,436],{}," reports \"Skipped\" with the file name and the reason, and that tile stays black. Open the file in Blender's image editor to see whether it loads, or convert it to png or jpg.",[12,5365,5367],{"id":5366},"why-does-blender-say-build-the-atlas-first","Why does Blender say \"Build the atlas first\"?",[17,5369,5370,305,5372,305,5374,612,5376,5378,5379,5381],{},[28,5371,468],{},[28,5373,474],{},[28,5375,611],{},[28,5377,513],{}," need an atlas in the current file. Press ",[28,5380,436],{}," first. The atlas is stored in the .blend, so this also appears in a file where it was never built.",[12,5383,5385],{"id":5384},"why-does-blender-say-select-mesh-objects","Why does Blender say \"Select mesh objects\"?",[17,5387,5388],{},"The buttons act only on selected objects of type mesh. Curves, empties, lights and cameras are ignored.",[12,5390,5392],{"id":5391},"why-does-my-object-show-one-stretched-colour-instead-of-an-image","Why does my object show one stretched colour instead of an image?",[17,5394,5395,5396,4570,5398,5400],{},"The object probably has no UV map, or its UVs do not cover the whole 0 to 1 square, so only a small part of the atlas is sampled. Unwrap the object so the UVs fill the square, or switch ",[28,5397,3253],{},[28,5399,1763],{}," to Front, Top or Side (no UVs).",[12,5402,5404],{"id":5403},"why-do-some-faces-look-streaked-with-front-top-or-side-mapping","Why do some faces look streaked with Front, Top or Side mapping?",[17,5406,5407],{},"These modes are one flat projection across the object's bounding box, not triplanar. Faces that point in other directions stretch the image into a streak. Use a UV map for objects where those faces matter.",[12,5409,5411],{"id":5410},"why-does-the-instances-button-say-no-instanced-source-found","Why does the instances button say \"No instanced source found\"?",[17,5413,5414,5415,4219],{},"The full message is \"No instanced source found: select the source objects and press again\". The add-on looks for objects used by Object Info and Collection Info nodes in the host's Geometry Nodes modifiers, including nested groups. If your setup gets its objects some other way, select the source meshes together with the host, keep the host active, and press ",[28,5416,474],{},[12,5418,5420],{"id":5419},"why-does-it-say-make-the-object-with-your-array-instance-on-points-modifier-active","Why does it say \"Make the object with your Array \u002F Instance on Points modifier active\"?",[17,5422,5423],{},"The active object must be a mesh. Click the host in the outliner so it is the active one, then press the button.",[12,5425,5427],{"id":5426},"why-do-my-instances-all-show-the-same-image","Why do my instances all show the same image?",[17,5429,5430,5431,5433],{},"Instances show the material of their source objects, not of the host. Check that the source objects have the shared material in slot 1 (the message after the button lists them). The image index is stored on the instance domain by the last modifier, so instances must still exist at that point. If an earlier modifier or node realizes the instances before the ",[28,5432,478],{}," modifier runs, there is nothing to store the index on. Keep the instances unrealized up to the end of the stack.",[12,5435,5437],{"id":5436},"why-did-my-images-change-after-pressing-build-atlas-again","Why did my images change after pressing Build Atlas again?",[17,5439,5440],{},"The atlas is always in natural file-name order. Rebuilding keeps each object's picture by file name, but if you renamed or removed files, the objects that pointed at them cannot be matched. They keep their old number, which wraps around if it is beyond the new image count.",[12,5442,5444],{"id":5443},"why-does-match-by-object-name-say-press-build-atlas-again","Why does Match By Object Name say \"Press Build Atlas again\"?",[17,5446,5447,5448,5450],{},"The message is \"Press Build Atlas again: this file has no image names stored yet\". The file was built with an older version that did not store the file names. Press ",[28,5449,436],{}," and try again.",[12,5452,5454],{"id":5453},"why-does-match-by-object-name-say-no-object-name-matches-an-image-file-name","Why does Match By Object Name say \"No object name matches an image file name\"?",[17,5456,5457,5458,5460,5461,90],{},"None of the selected objects have a name equal to, or containing, a file name. The match ignores case and a trailing ",[456,5459,3225],{},". Rename the objects, or use ",[28,5462,611],{},[12,5464,5466],{"id":5465},"why-does-assign-image-to-selected-say-the-image-number-is-too-high","Why does Assign Image To Selected say the Image Number is too high?",[17,5468,5469],{},"The message reads \"Image Number N is too high: the atlas has M images\". Lower the number, or rebuild the atlas with more images.",[12,5471,5473],{"id":5472},"why-do-two-files-like-catpng-and-catjpg-appear-as-one-name","Why do two files like cat.png and cat.jpg appear as one name?",[17,5475,5476,5477,5480,5481,5483],{},"The picker uses file names without the extension, so both show as ",[456,5478,5479],{},"cat",". Choose them by ",[28,5482,3179],{}," instead.",[12,5485,5487],{"id":5486},"why-does-shuffle-look-repetitive","Why does Shuffle look repetitive?",[17,5489,5490,5491,5493,5494,90],{},"Shuffle spreads images evenly, but with few images the pattern can show a rhythm. Change ",[28,5492,488],{}," and press the button again, or add ",[28,5495,1769],{},[12,5497,5499],{"id":5498},"do-the-instances-and-the-separate-objects-shuffle-the-same-way","Do the instances and the separate objects shuffle the same way?",[17,5501,5502],{},"No. For separate objects the add-on shuffles the object list with the Seed. For instances the modifier steps through the images with a step that fits the image count and an offset taken from the Seed.",[12,5504,1126],{"id":1125},[33,5506,5507,5511,5515],{},[36,5508,1131,5509],{},[86,5510,715],{"href":716},[36,5512,5513],{},[86,5514,1036],{"href":561},[36,5516,379,5517],{},[86,5518,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":5520},[5521,5522,5523,5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536,5537,5538,5539,5540],{"id":5317,"depth":387,"text":5318},{"id":5329,"depth":387,"text":5330},{"id":5336,"depth":387,"text":5337},{"id":5349,"depth":387,"text":5350},{"id":5356,"depth":387,"text":5357},{"id":5366,"depth":387,"text":5367},{"id":5384,"depth":387,"text":5385},{"id":5391,"depth":387,"text":5392},{"id":5403,"depth":387,"text":5404},{"id":5410,"depth":387,"text":5411},{"id":5419,"depth":387,"text":5420},{"id":5426,"depth":387,"text":5427},{"id":5436,"depth":387,"text":5437},{"id":5443,"depth":387,"text":5444},{"id":5453,"depth":387,"text":5454},{"id":5465,"depth":387,"text":5466},{"id":5472,"depth":387,"text":5473},{"id":5486,"depth":387,"text":5487},{"id":5498,"depth":387,"text":5499},{"id":1125,"depth":387,"text":1126},"Fixes for Image Per Instance in Blender: what each error message means, atlas size limits, missing UVs, instances not found, repeated images and Lite limits.",{},"---\ntitle: \"Image Per Instance troubleshooting\"\ndescription: \"Fixes for Image Per Instance in Blender: what each error message means, atlas size limits, missing UVs, instances not found, repeated images and Lite limits.\"\naddon: image-per-instance\norder: 8\nupdated: 2026-11-16\n---\n\nEach answer below uses the message text the add-on shows at the bottom of Blender. If your problem is not here, write to support@mendboxstudio.com with your Blender version and the add-on version shown at the bottom of the panel.\n\n## What does \"Choose an image folder first\" mean?\n\n**Build Atlas** was pressed while **Image Folder** is empty. Click the folder icon next to Image Folder and choose a folder.\n\n## Why does Blender say \"No images found\" in my folder?\n\nThe folder exists but holds no supported files directly inside it. Supported types are png, jpg, jpeg, tif, tiff, bmp, webp, exr and tga. Subfolders are not searched, so move the images up one level or point to the subfolder. The message includes the folder path it looked in, so check it for typos.\n\n## What if the atlas is too big (limit 16384)?\n\nThe message reads \"Atlas would be W x H px (limit 16384). Use a smaller tile size or fewer images\". The atlas can be at most 16384 px on each side. 256 images at 1024 px fit exactly. 257 do not. Lower **Tile Size**, or use fewer images. A non-square **Tile Shape** changes the sizes too.\n\n## Why does the Lite version say \"This free version supports up to 20 images\"?\n\nLite builds atlases of up to 20 images. Move extra files out of the folder, or use the full version, which has no image limit in the add-on.\n\n## Why are some images black or missing in the atlas?\n\nIf a file cannot be read, **Build Atlas** reports \"Skipped\" with the file name and the reason, and that tile stays black. Open the file in Blender's image editor to see whether it loads, or convert it to png or jpg.\n\n## Why does Blender say \"Build the atlas first\"?\n\n**Apply To Selected Objects**, **Add To Instances (Geometry Nodes)**, **Assign Image To Selected** and **Match By Object Name** need an atlas in the current file. Press **Build Atlas** first. The atlas is stored in the .blend, so this also appears in a file where it was never built.\n\n## Why does Blender say \"Select mesh objects\"?\n\nThe buttons act only on selected objects of type mesh. Curves, empties, lights and cameras are ignored.\n\n## Why does my object show one stretched colour instead of an image?\n\nThe object probably has no UV map, or its UVs do not cover the whole 0 to 1 square, so only a small part of the atlas is sampled. Unwrap the object so the UVs fill the square, or switch **Mapping** under **Material** to Front, Top or Side (no UVs).\n\n## Why do some faces look streaked with Front, Top or Side mapping?\n\nThese modes are one flat projection across the object's bounding box, not triplanar. Faces that point in other directions stretch the image into a streak. Use a UV map for objects where those faces matter.\n\n## Why does the instances button say \"No instanced source found\"?\n\nThe full message is \"No instanced source found: select the source objects and press again\". The add-on looks for objects used by Object Info and Collection Info nodes in the host's Geometry Nodes modifiers, including nested groups. If your setup gets its objects some other way, select the source meshes together with the host, keep the host active, and press **Add To Instances (Geometry Nodes)** again.\n\n## Why does it say \"Make the object with your Array \u002F Instance on Points modifier active\"?\n\nThe active object must be a mesh. Click the host in the outliner so it is the active one, then press the button.\n\n## Why do my instances all show the same image?\n\nInstances show the material of their source objects, not of the host. Check that the source objects have the shared material in slot 1 (the message after the button lists them). The image index is stored on the instance domain by the last modifier, so instances must still exist at that point. If an earlier modifier or node realizes the instances before the **IPI Assign Index** modifier runs, there is nothing to store the index on. Keep the instances unrealized up to the end of the stack.\n\n## Why did my images change after pressing Build Atlas again?\n\nThe atlas is always in natural file-name order. Rebuilding keeps each object's picture by file name, but if you renamed or removed files, the objects that pointed at them cannot be matched. They keep their old number, which wraps around if it is beyond the new image count.\n\n## Why does Match By Object Name say \"Press Build Atlas again\"?\n\nThe message is \"Press Build Atlas again: this file has no image names stored yet\". The file was built with an older version that did not store the file names. Press **Build Atlas** and try again.\n\n## Why does Match By Object Name say \"No object name matches an image file name\"?\n\nNone of the selected objects have a name equal to, or containing, a file name. The match ignores case and a trailing `.001`. Rename the objects, or use **Assign Image To Selected**.\n\n## Why does Assign Image To Selected say the Image Number is too high?\n\nThe message reads \"Image Number N is too high: the atlas has M images\". Lower the number, or rebuild the atlas with more images.\n\n## Why do two files like cat.png and cat.jpg appear as one name?\n\nThe picker uses file names without the extension, so both show as `cat`. Choose them by **Image Number** instead.\n\n## Why does Shuffle look repetitive?\n\nShuffle spreads images evenly, but with few images the pattern can show a rhythm. Change **Seed** and press the button again, or add **Random Variation**.\n\n## Do the instances and the separate objects shuffle the same way?\n\nNo. For separate objects the add-on shuffles the object list with the Seed. For instances the modifier steps through the images with a step that fits the image count and an offset taken from the Seed.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":5306,"description":5541},"docs\u002Fimage-per-instance\u002Ftroubleshooting","EVdj8OznOTzKrt69rJ8yq1Jb9Lob1CqXBu4VHVfIaVs",{"id":5548,"title":5549,"addon":1325,"body":5550,"description":5915,"extension":403,"meta":5916,"navigation":408,"order":5299,"path":835,"rawbody":5917,"seo":5918,"stem":5919,"updated":417,"__hash__":5920},"docs\u002Fdocs\u002Fquadfix\u002Ftroubleshooting.md","QuadFix troubleshooting: errors and fixes",{"type":9,"value":5551,"toc":5884},[5552,5557,5561,5567,5571,5583,5587,5604,5608,5615,5619,5622,5626,5632,5636,5642,5646,5649,5653,5658,5662,5665,5669,5672,5676,5679,5683,5686,5690,5693,5697,5704,5708,5718,5722,5737,5741,5744,5748,5757,5761,5772,5776,5784,5788,5793,5797,5800,5804,5810,5814,5826,5830,5833,5837,5849,5853,5864,5866],[17,5553,5554,5555,90],{},"Messages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the ",[86,5556,89],{"href":792},[12,5558,5560],{"id":5559},"why-are-the-quadfix-buttons-greyed-out","Why are the QuadFix buttons greyed out?",[17,5562,5563,5564,5566],{},"The mesh tools only work in Edit Mode, and Union to Quads only works in Object Mode. The panel shows the other group greyed out with a hint to press ",[456,5565,1388],{},". Union to Quads also needs at least two selected mesh objects, with a mesh as the active object. If the tab does not show at all, check that the 3D viewport is in Object Mode or Edit Mode, and not Sculpt or Paint.",[12,5568,5570],{"id":5569},"why-does-fill-holes-say-no-boundary-edges-holes-in-selection","Why does Fill Holes say \"No boundary edges (holes) in selection\"?",[17,5572,5573,5574,5576,5577,5579,5580,5582],{},"Fill Holes with ",[28,5575,1417],{}," on looks for open edges in your selection. Either nothing selected is a boundary edge, or the mesh has no holes. Press ",[28,5578,779],{}," to select the open edges, then press ",[28,5581,755],{},". A mesh without any open edge, such as a closed sphere, has no holes.",[12,5584,5586],{"id":5585},"why-does-fill-holes-say-nothing-to-fill","Why does Fill Holes say \"Nothing to fill\"?",[17,5588,5589,5590,5593,5594,5597,5598,5600,5601,5603],{},"The message lists the reasons. ",[456,5591,5592],{},"outer border(s)"," means the loop is the rim of a flat open sheet such as a plane, terrain or cloth, which QuadFix does not treat as a hole. ",[456,5595,5596],{},"partly selected hole(s)"," means only some edges of a hole loop are selected. Select the full loop, or turn ",[28,5599,1417],{}," off to consider the whole mesh. Select by edge loop with ",[456,5602,4846],{}," and click on one edge of the hole.",[12,5605,5607],{"id":5606},"why-was-one-of-my-holes-skipped","Why was one of my holes skipped?",[17,5609,5610,5611,5614],{},"Two cases: its loop is only partly selected, or it looks like the outer border of a flat sheet. Both are counted in the result line, for example ",[456,5612,5613],{},"1 partly selected hole(s) skipped",". Fix the selection and run the tool again.",[12,5616,5618],{"id":5617},"why-did-fill-holes-close-an-opening-i-wanted-open","Why did Fill Holes close an opening I wanted open?",[17,5620,5621],{},"Fill Holes closes every closed boundary loop that is fully selected. That includes things such as eye sockets or the end of a tube. Select only the holes you want closed before pressing the button, or undo and run it again.",[12,5623,5625],{"id":5624},"why-does-the-patch-have-triangles-instead-of-quads","Why does the patch have triangles instead of quads?",[17,5627,5628,5629,5631],{},"If at least 70 percent of the faces around the patch are triangles, ",[28,5630,3686],{}," makes the patch triangular on purpose. Untick it for a quad patch. Otherwise a very irregular outline can leave a few triangles, which are also counted in the result line.",[12,5633,5635],{"id":5634},"why-does-bridge-to-quads-say-select-two-edge-loops-or-open-edge-chains-edge-select-mode","Why does Bridge to Quads say \"select two edge loops or open edge chains (Edge select mode)\"?",[17,5637,5638,5639,5641],{},"Nothing usable is selected. Switch to Edge select mode with ",[456,5640,4840],{},", select two loops or chains of boundary edges, then run the tool again. In Vertex select mode, edges that already have faces on both sides are ignored, so only the open edges count.",[12,5643,5645],{"id":5644},"why-does-bridge-to-quads-say-selected-edges-already-have-faces-on-both-sides","Why does Bridge to Quads say selected edges \"already have faces on both sides\"?",[17,5647,5648],{},"Bridge needs open edges, those with a face on at most one side. The message selects the offending edges. If you are in Face select mode, QuadFix switches to Edge select mode so you can see them. Deselect those edges and select the boundary of the openings instead.",[12,5650,5652],{"id":5651},"why-does-bridge-to-quads-say-only-one-loop-or-chain-is-selected","Why does Bridge to Quads say \"only one loop or chain is selected\"?",[17,5654,5655,5656,90],{},"It needs exactly two sides. A single hole is closed with ",[28,5657,755],{},[12,5659,5661],{"id":5660},"why-does-bridge-to-quads-say-separate-loops-or-chains-are-selected-select-exactly-two","Why does Bridge to Quads say \"separate loops or chains are selected: select exactly two\"?",[17,5663,5664],{},"More than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.",[12,5666,5668],{"id":5667},"why-does-bridge-to-quads-say-the-selection-branches-or-a-loop-touches-itself","Why does Bridge to Quads say the selection branches or a loop touches itself?",[17,5670,5671],{},"The selection must be two simple loops or chains. Where three or more selected edges meet in one vertex, the selection branches. A loop that crosses itself is refused as well. Select the two loops separately and leave out the forks.",[12,5673,5675],{"id":5674},"why-does-bridge-to-quads-say-one-side-is-a-closed-loop-and-the-other-an-open-chain","Why does Bridge to Quads say \"one side is a closed loop and the other an open chain\"?",[17,5677,5678],{},"Both sides must be the same kind: two closed loops or two open chains. Select a matching pair.",[12,5680,5682],{"id":5681},"why-does-bridge-to-quads-say-the-sides-have-different-edge-counts-for-example-40-and-8-edges","Why does Bridge to Quads say the sides have different edge counts, for example 40 and 8 edges?",[17,5684,5685],{},"The two sides may differ by at most 4 to 1 in edge count. Add edge loops to the sparser side, or remove some from the dense one, until the ratio is 4 to 1 or less. Then bridge them.",[12,5687,5689],{"id":5688},"why-does-bridge-to-quads-say-a-loop-needs-at-least-three-edges","Why does Bridge to Quads say \"a loop needs at least three edges\"?",[17,5691,5692],{},"A closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.",[12,5694,5696],{"id":5695},"why-does-bridge-to-quads-say-the-two-sides-face-opposite-ways","Why does Bridge to Quads say the two sides face opposite ways?",[17,5698,5699,5700,5703],{},"The faces beside the two loops have normals that point in opposite directions. Use ",[28,5701,5702],{},"Mesh > Normals > Recalculate Outside",", then bridge again. If the normals are correct and the surfaces really face each other, that is the case this check is meant to refuse.",[12,5705,5707],{"id":5706},"why-does-bridge-to-quads-say-a-loop-has-no-length","Why does Bridge to Quads say a loop \"has no length\"?",[17,5709,5710,5711,5714,5715,5717],{},"The vertices of a selected loop sit on top of each other. Run ",[28,5712,5713],{},"Mesh > Clean Up > Merge by Distance",", or ",[28,5716,2137],{},", then select the loops again.",[12,5719,5721],{"id":5720},"why-does-bridge-to-quads-say-the-strip-folds-twists-or-no-quad-layout","Why does Bridge to Quads say \"the strip folds\", \"twists\" or \"no quad layout\"?",[17,5723,5724,5725,5727,5728,5730,5731,5733,5734,5736],{},"The result is checked, and a strip that would fold back on itself, twist into bow-tie quads, create non-manifold edges or zero-area faces is removed. The mesh is left as it was and the problem edges are selected. Try a different ",[28,5726,2542],{}," value with ",[28,5729,3746],{}," off, set ",[28,5732,3766],{}," to 0, or choose loops that are less tilted against each other. A closed loop of three edges is better closed with ",[28,5735,755],{},". If the two sides are already connected by faces, the message says so, and there is nothing to bridge. If you ask for Smoothness and the curved rows would fold, QuadFix tries the straight strip and the report says that Smoothness was dropped.",[12,5738,5740],{"id":5739},"why-does-the-bridge-leave-one-triangle","Why does the bridge leave one triangle?",[17,5742,5743],{},"A quad mesh has an even number of boundary edges. When the two sides have an odd number of edges in total, one triangle cannot be avoided. The report says so and selects the triangle with the strip. Add or remove one edge on one side to get an all-quad strip.",[12,5745,5747],{"id":5746},"why-does-n-gons-to-quads-say-nothing-to-convert-all-quads-or-flat-n-gons","Why does N-gons to Quads say \"Nothing to convert (all quads or flat n-gons)\"?",[17,5749,5750,5751,5753,5754,5756],{},"Everything in the selection is already a quad, or is a flat n-gon protected by ",[28,5752,3858],{},". Switch that option off to convert flat n-gons as well. Check that ",[28,5755,1417],{}," is not hiding the faces you want to process.",[12,5758,5760],{"id":5759},"why-do-triangles-remain-after-n-gons-to-quads-or-clean-quad","Why do triangles remain after N-gons to Quads or Clean & Quad?",[17,5762,5763,5764,612,5766,5768,5769,5771],{},"Two triangles are joined only when the angles are within ",[28,5765,3837],{},[28,5767,3848],{},". Triangles with no suitable neighbour stay. Raise the angles or switch on ",[28,5770,3868],{},", then run it again from undo. Irregular scans keep some triangles whatever you do. QuadFix does not rebuild edge flow, so for a full retopology you need a remesher.",[12,5773,5775],{"id":5774},"why-did-clean-quad-leave-some-n-gons-or-triangles-alone","Why did Clean & Quad leave some n-gons or triangles alone?",[17,5777,5778,5779,5781,5782,2532],{},"Flat n-gons that were in the mesh before the run stay when ",[28,5780,3858],{}," is on. Triangle fans at the poles of spheres and the caps of cylinders are recognised as clean and left alone. Edges marked sharp or seam are not dissolved while ",[28,5783,3942],{},[12,5785,5787],{"id":5786},"why-did-clean-quad-change-nothing-near-my-corners","Why did Clean & Quad change nothing near my corners?",[17,5789,5790,5791,90],{},"The dissolve step only works around triangles, n-gons and open edges. A grid of quads is considered clean. That keeps a finely curved quad surface from being torn up. If the mesh really needs a stronger cleanup, raise ",[28,5792,3931],{},[12,5794,5796],{"id":5795},"why-does-union-to-quads-say-the-objects-do-not-intersect-nothing-was-changed","Why does Union to Quads say \"The objects do not intersect: nothing was changed\"?",[17,5798,5799],{},"The Boolean found no seam between the objects. Move them so their surfaces cross, or check that they are overlapping meshes and not two separate pieces.",[12,5801,5803],{"id":5802},"why-does-union-to-quads-say-boolean-union-produced-no-faces","Why does Union to Quads say \"Boolean union produced no faces\"?",[17,5805,5806,5807,5809],{},"Blender's exact Boolean returned an empty mesh. The message asks whether both meshes are closed and overlap. Make sure both objects are closed meshes, with no holes and no flipped normals. Use ",[28,5808,779],{}," on each object to check for open boundary edges, and fill the holes first.",[12,5811,5813],{"id":5812},"why-does-union-to-quads-report-left-as-plain-boolean","Why does Union to Quads report \"left as plain boolean\"?",[17,5815,5816,5817,5819,5820,5822,5823,5825],{},"Some seams were not rebuilt cleanly. The result of such a seam would have changed the surface by more than ",[28,5818,4017],{},", or a seam runs through a hole in one of the inputs, or no acceptable strip was found. That seam keeps the normal Boolean result and the message is a warning with the count. Try a different ",[28,5821,4006],{}," value instead of Auto, or raise ",[28,5824,4017],{}," a little. Fill holes in the inputs before the union.",[12,5827,5829],{"id":5828},"why-is-the-union-to-quads-seam-a-zig-zag","Why is the Union to Quads seam a zig-zag?",[17,5831,5832],{},"On dense meshes with very different density on the two sides, the strip is all quads but visibly zig-zags. Make the two meshes more similar in density before the union. UVs for the new strip are not generated, so unwrap after the union.",[12,5834,5836],{"id":5835},"where-did-the-other-objects-go-after-union-to-quads","Where did the other objects go after Union to Quads?",[17,5838,5839,5840,5842,5843,5845,5846,5848],{},"They are hidden. Use ",[28,5841,4049],{},". With ",[28,5844,4028],{}," off they are deleted, so ",[456,5847,1407],{}," is the way back.",[12,5850,5852],{"id":5851},"how-do-i-undo-a-quadfix-step","How do I undo a QuadFix step?",[17,5854,5855,5856,1408,5858,5860,5861,5863],{},"Every tool is a normal Blender undo step. ",[456,5857,1407],{},[456,5859,1411],{}," on Mac) reverts it in one go. If you are still stuck, write to ",[86,5862,912],{"href":911}," and attach a small .blend file that shows the problem.",[12,5865,1126],{"id":1125},[33,5867,5868,5872,5876],{},[36,5869,1131,5870],{},[86,5871,747],{"href":949},[36,5873,5874],{},[86,5875,1036],{"href":796},[36,5877,1461,5878,305,5880,612,5882],{},[86,5879,1464],{"href":858},[86,5881,1467],{"href":865},[86,5883,1470],{"href":872},{"title":386,"searchDepth":387,"depth":387,"links":5885},[5886,5887,5888,5889,5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904,5905,5906,5907,5908,5909,5910,5911,5912,5913,5914],{"id":5559,"depth":387,"text":5560},{"id":5569,"depth":387,"text":5570},{"id":5585,"depth":387,"text":5586},{"id":5606,"depth":387,"text":5607},{"id":5617,"depth":387,"text":5618},{"id":5624,"depth":387,"text":5625},{"id":5634,"depth":387,"text":5635},{"id":5644,"depth":387,"text":5645},{"id":5651,"depth":387,"text":5652},{"id":5660,"depth":387,"text":5661},{"id":5667,"depth":387,"text":5668},{"id":5674,"depth":387,"text":5675},{"id":5681,"depth":387,"text":5682},{"id":5688,"depth":387,"text":5689},{"id":5695,"depth":387,"text":5696},{"id":5706,"depth":387,"text":5707},{"id":5720,"depth":387,"text":5721},{"id":5739,"depth":387,"text":5740},{"id":5746,"depth":387,"text":5747},{"id":5759,"depth":387,"text":5760},{"id":5774,"depth":387,"text":5775},{"id":5786,"depth":387,"text":5787},{"id":5795,"depth":387,"text":5796},{"id":5802,"depth":387,"text":5803},{"id":5812,"depth":387,"text":5813},{"id":5828,"depth":387,"text":5829},{"id":5835,"depth":387,"text":5836},{"id":5851,"depth":387,"text":5852},{"id":1125,"depth":387,"text":1126},"Fix common QuadFix problems in Blender: greyed-out buttons, holes that are not filled, Bridge to Quads refusals, leftover triangles and Union to Quads warnings.",{},"---\ntitle: \"QuadFix troubleshooting: errors and fixes\"\ndescription: \"Fix common QuadFix problems in Blender: greyed-out buttons, holes that are not filled, Bridge to Quads refusals, leftover triangles and Union to Quads warnings.\"\naddon: quadfix\norder: 8\nupdated: 2026-11-16\n---\n\nMessages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the [panel reference](\u002Fdocs\u002Fquadfix\u002Fpanel).\n\n## Why are the QuadFix buttons greyed out?\n\nThe mesh tools only work in Edit Mode, and Union to Quads only works in Object Mode. The panel shows the other group greyed out with a hint to press `Tab`. Union to Quads also needs at least two selected mesh objects, with a mesh as the active object. If the tab does not show at all, check that the 3D viewport is in Object Mode or Edit Mode, and not Sculpt or Paint.\n\n## Why does Fill Holes say \"No boundary edges (holes) in selection\"?\n\nFill Holes with **Only Selected** on looks for open edges in your selection. Either nothing selected is a boundary edge, or the mesh has no holes. Press **Select Non-Quads & Holes** to select the open edges, then press **Fill Holes with Quads**. A mesh without any open edge, such as a closed sphere, has no holes.\n\n## Why does Fill Holes say \"Nothing to fill\"?\n\nThe message lists the reasons. `outer border(s)` means the loop is the rim of a flat open sheet such as a plane, terrain or cloth, which QuadFix does not treat as a hole. `partly selected hole(s)` means only some edges of a hole loop are selected. Select the full loop, or turn **Only Selected** off to consider the whole mesh. Select by edge loop with `Alt` and click on one edge of the hole.\n\n## Why was one of my holes skipped?\n\nTwo cases: its loop is only partly selected, or it looks like the outer border of a flat sheet. Both are counted in the result line, for example `1 partly selected hole(s) skipped`. Fix the selection and run the tool again.\n\n## Why did Fill Holes close an opening I wanted open?\n\nFill Holes closes every closed boundary loop that is fully selected. That includes things such as eye sockets or the end of a tube. Select only the holes you want closed before pressing the button, or undo and run it again.\n\n## Why does the patch have triangles instead of quads?\n\nIf at least 70 percent of the faces around the patch are triangles, **Match Triangle Meshes** makes the patch triangular on purpose. Untick it for a quad patch. Otherwise a very irregular outline can leave a few triangles, which are also counted in the result line.\n\n## Why does Bridge to Quads say \"select two edge loops or open edge chains (Edge select mode)\"?\n\nNothing usable is selected. Switch to Edge select mode with `2`, select two loops or chains of boundary edges, then run the tool again. In Vertex select mode, edges that already have faces on both sides are ignored, so only the open edges count.\n\n## Why does Bridge to Quads say selected edges \"already have faces on both sides\"?\n\nBridge needs open edges, those with a face on at most one side. The message selects the offending edges. If you are in Face select mode, QuadFix switches to Edge select mode so you can see them. Deselect those edges and select the boundary of the openings instead.\n\n## Why does Bridge to Quads say \"only one loop or chain is selected\"?\n\nIt needs exactly two sides. A single hole is closed with **Fill Holes with Quads**.\n\n## Why does Bridge to Quads say \"separate loops or chains are selected: select exactly two\"?\n\nMore than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.\n\n## Why does Bridge to Quads say the selection branches or a loop touches itself?\n\nThe selection must be two simple loops or chains. Where three or more selected edges meet in one vertex, the selection branches. A loop that crosses itself is refused as well. Select the two loops separately and leave out the forks.\n\n## Why does Bridge to Quads say \"one side is a closed loop and the other an open chain\"?\n\nBoth sides must be the same kind: two closed loops or two open chains. Select a matching pair.\n\n## Why does Bridge to Quads say the sides have different edge counts, for example 40 and 8 edges?\n\nThe two sides may differ by at most 4 to 1 in edge count. Add edge loops to the sparser side, or remove some from the dense one, until the ratio is 4 to 1 or less. Then bridge them.\n\n## Why does Bridge to Quads say \"a loop needs at least three edges\"?\n\nA closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.\n\n## Why does Bridge to Quads say the two sides face opposite ways?\n\nThe faces beside the two loops have normals that point in opposite directions. Use **Mesh > Normals > Recalculate Outside**, then bridge again. If the normals are correct and the surfaces really face each other, that is the case this check is meant to refuse.\n\n## Why does Bridge to Quads say a loop \"has no length\"?\n\nThe vertices of a selected loop sit on top of each other. Run **Mesh > Clean Up > Merge by Distance**, or **Clean & Quad**, then select the loops again.\n\n## Why does Bridge to Quads say \"the strip folds\", \"twists\" or \"no quad layout\"?\n\nThe result is checked, and a strip that would fold back on itself, twist into bow-tie quads, create non-manifold edges or zero-area faces is removed. The mesh is left as it was and the problem edges are selected. Try a different **Cuts** value with **Auto Cuts** off, set **Smoothness** to 0, or choose loops that are less tilted against each other. A closed loop of three edges is better closed with **Fill Holes with Quads**. If the two sides are already connected by faces, the message says so, and there is nothing to bridge. If you ask for Smoothness and the curved rows would fold, QuadFix tries the straight strip and the report says that Smoothness was dropped.\n\n## Why does the bridge leave one triangle?\n\nA quad mesh has an even number of boundary edges. When the two sides have an odd number of edges in total, one triangle cannot be avoided. The report says so and selects the triangle with the strip. Add or remove one edge on one side to get an all-quad strip.\n\n## Why does N-gons to Quads say \"Nothing to convert (all quads or flat n-gons)\"?\n\nEverything in the selection is already a quad, or is a flat n-gon protected by **Keep Planar N-gons**. Switch that option off to convert flat n-gons as well. Check that **Only Selected** is not hiding the faces you want to process.\n\n## Why do triangles remain after N-gons to Quads or Clean & Quad?\n\nTwo triangles are joined only when the angles are within **Face Angle** and **Shape Angle**. Triangles with no suitable neighbour stay. Raise the angles or switch on **Aggressive Quads**, then run it again from undo. Irregular scans keep some triangles whatever you do. QuadFix does not rebuild edge flow, so for a full retopology you need a remesher.\n\n## Why did Clean & Quad leave some n-gons or triangles alone?\n\nFlat n-gons that were in the mesh before the run stay when **Keep Planar N-gons** is on. Triangle fans at the poles of spheres and the caps of cylinders are recognised as clean and left alone. Edges marked sharp or seam are not dissolved while **Keep Sharp Edges** is on.\n\n## Why did Clean & Quad change nothing near my corners?\n\nThe dissolve step only works around triangles, n-gons and open edges. A grid of quads is considered clean. That keeps a finely curved quad surface from being torn up. If the mesh really needs a stronger cleanup, raise **Dissolve Angle**.\n\n## Why does Union to Quads say \"The objects do not intersect: nothing was changed\"?\n\nThe Boolean found no seam between the objects. Move them so their surfaces cross, or check that they are overlapping meshes and not two separate pieces.\n\n## Why does Union to Quads say \"Boolean union produced no faces\"?\n\nBlender's exact Boolean returned an empty mesh. The message asks whether both meshes are closed and overlap. Make sure both objects are closed meshes, with no holes and no flipped normals. Use **Select Non-Quads & Holes** on each object to check for open boundary edges, and fill the holes first.\n\n## Why does Union to Quads report \"left as plain boolean\"?\n\nSome seams were not rebuilt cleanly. The result of such a seam would have changed the surface by more than **Max Shape Change %**, or a seam runs through a hole in one of the inputs, or no acceptable strip was found. That seam keeps the normal Boolean result and the message is a warning with the count. Try a different **Rings** value instead of Auto, or raise **Max Shape Change %** a little. Fill holes in the inputs before the union.\n\n## Why is the Union to Quads seam a zig-zag?\n\nOn dense meshes with very different density on the two sides, the strip is all quads but visibly zig-zags. Make the two meshes more similar in density before the union. UVs for the new strip are not generated, so unwrap after the union.\n\n## Where did the other objects go after Union to Quads?\n\nThey are hidden. Use **Object > Show\u002FHide > Reveal Hidden**. With **Keep Originals Hidden** off they are deleted, so `Ctrl+Z` is the way back.\n\n## How do I undo a QuadFix step?\n\nEvery tool is a normal Blender undo step. `Ctrl+Z` (`Cmd+Z` on Mac) reverts it in one go. If you are still stuck, write to support@mendboxstudio.com and attach a small .blend file that shows the problem.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Workflows](\u002Fdocs\u002Fquadfix\u002Fworkflows)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":5549,"description":5915},"docs\u002Fquadfix\u002Ftroubleshooting","CQNvvl5eI4l8O7afth99gPDfciv-efcqlJ5wU1xIYP8",{"id":5922,"title":5923,"addon":1164,"body":5924,"description":6057,"extension":403,"meta":6058,"navigation":408,"order":6059,"path":692,"rawbody":6060,"seo":6061,"stem":6062,"updated":417,"__hash__":6063},"docs\u002Fdocs\u002Fimage-per-instance\u002Fchangelog.md","Image Per Instance changelog",{"type":9,"value":5925,"toc":6047},[5926,5930,5969,5973,5978,5982,5990,5994,5999,6003,6008,6011,6016,6020,6025,6031,6033],[12,5927,5929],{"id":5928},"_020-2026-11-10","0.2.0 (2026-11-10)",[33,5931,5932,5935,5938,5941,5944,5947,5950,5957,5960,5963,5966],{},[36,5933,5934],{},"Tile shape and fit modes: Stretch, Fit with bars (Bar Colour) and Fill (crop).",[36,5936,5937],{},"Assign Image To Selected, Match By Object Name and an image picker with a search field.",[36,5939,5940],{},"Material options: Use Image Alpha, Emissive (screen) with Strength, and Roughness, applied at once.",[36,5942,5943],{},"Mapping without UVs: Front, Top and Side.",[36,5945,5946],{},"Animate with Frames Per Image.",[36,5948,5949],{},"Random Variation: Hue, Saturation, Brightness, Flip X and Flip Y.",[36,5951,5952,5953,4432,5955,90],{},"Natural file order, so ",[456,5954,458],{},[456,5956,462],{},[36,5958,5959],{},"Build Atlas again keeps each object's picture, matched by file name.",[36,5961,5962],{},"Fixed brightness of 16-bit and EXR source images.",[36,5964,5965],{},"The 3D view now redraws right after a button press.",[36,5967,5968],{},"With Order set to Shuffle, the atlas stays in file-name order.",[12,5970,5972],{"id":5971},"_017-2026-10-03","0.1.7 (2026-10-03)",[33,5974,5975],{},[36,5976,5977],{},"The image goes only on material slot 1. Other slots on your source object stay untouched.",[12,5979,5981],{"id":5980},"_016","0.1.6",[33,5983,5984,5987],{},[36,5985,5986],{},"An empty or wrong folder gives a clear error message.",[36,5988,5989],{},"The version is shown in the panel.",[12,5991,5993],{"id":5992},"_015","0.1.5",[33,5995,5996],{},[36,5997,5998],{},"Shuffle never reverses the order.",[12,6000,6002],{"id":6001},"_014","0.1.4",[33,6004,6005],{},[36,6006,6007],{},"Version number added to the panel.",[12,6009,418],{"id":6010},"_013",[33,6012,6013],{},[36,6014,6015],{},"Shuffle spreads images instead of shifting them.",[12,6017,6019],{"id":6018},"_012-and-earlier","0.1.2 and earlier",[33,6021,6022],{},[36,6023,6024],{},"First working builds, Geometry Nodes instances and fixes from testing in the Blender interface.",[17,6026,6027,6028,6030],{},"The free Lite version has its own history: Lite 0.2.0 added natural file order, the brightness fix for 16-bit and EXR images, the redraw fix and a rebuild that keeps pictures, and Lite 0.1.7 put the image on slot 1 only. See the ",[86,6029,658],{"href":657}," for what Lite includes.",[12,6032,1126],{"id":1125},[33,6034,6035,6039,6043],{},[36,6036,1131,6037],{},[86,6038,715],{"href":716},[36,6040,6041],{},[86,6042,370],{"href":628},[36,6044,379,6045],{},[86,6046,567],{"href":566},{"title":386,"searchDepth":387,"depth":387,"links":6048},[6049,6050,6051,6052,6053,6054,6055,6056],{"id":5928,"depth":387,"text":5929},{"id":5971,"depth":387,"text":5972},{"id":5980,"depth":387,"text":5981},{"id":5992,"depth":387,"text":5993},{"id":6001,"depth":387,"text":6002},{"id":6010,"depth":387,"text":418},{"id":6018,"depth":387,"text":6019},{"id":1125,"depth":387,"text":1126},"Version history of the Image Per Instance Blender add-on, newest first: what changed in 0.2.0, 0.1.7 and the earlier builds, with release dates where known.",{},9,"---\ntitle: \"Image Per Instance changelog\"\ndescription: \"Version history of the Image Per Instance Blender add-on, newest first: what changed in 0.2.0, 0.1.7 and the earlier builds, with release dates where known.\"\naddon: image-per-instance\norder: 9\nupdated: 2026-11-16\n---\n\n## 0.2.0 (2026-11-10)\n\n- Tile shape and fit modes: Stretch, Fit with bars (Bar Colour) and Fill (crop).\n- Assign Image To Selected, Match By Object Name and an image picker with a search field.\n- Material options: Use Image Alpha, Emissive (screen) with Strength, and Roughness, applied at once.\n- Mapping without UVs: Front, Top and Side.\n- Animate with Frames Per Image.\n- Random Variation: Hue, Saturation, Brightness, Flip X and Flip Y.\n- Natural file order, so `img2` comes before `img10`.\n- Build Atlas again keeps each object's picture, matched by file name.\n- Fixed brightness of 16-bit and EXR source images.\n- The 3D view now redraws right after a button press.\n- With Order set to Shuffle, the atlas stays in file-name order.\n\n## 0.1.7 (2026-10-03)\n\n- The image goes only on material slot 1. Other slots on your source object stay untouched.\n\n## 0.1.6\n\n- An empty or wrong folder gives a clear error message.\n- The version is shown in the panel.\n\n## 0.1.5\n\n- Shuffle never reverses the order.\n\n## 0.1.4\n\n- Version number added to the panel.\n\n## 0.1.3\n\n- Shuffle spreads images instead of shifting them.\n\n## 0.1.2 and earlier\n\n- First working builds, Geometry Nodes instances and fixes from testing in the Blender interface.\n\nThe free Lite version has its own history: Lite 0.2.0 added natural file order, the brightness fix for 16-bit and EXR images, the redraw fix and a rebuild that keeps pictures, and Lite 0.1.7 put the image on slot 1 only. See the [install page](\u002Fdocs\u002Fimage-per-instance\u002Finstall) for what Lite includes.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":5923,"description":6057},"docs\u002Fimage-per-instance\u002Fchangelog","GwUn4ednbvLPBscpfzb5yrxirLsRPy2DWwRogjh9_P0",{"id":6065,"title":6066,"addon":1325,"body":6067,"description":6328,"extension":403,"meta":6329,"navigation":408,"order":6059,"path":929,"rawbody":6330,"seo":6331,"stem":6332,"updated":417,"__hash__":6333},"docs\u002Fdocs\u002Fquadfix\u002Fchangelog.md","QuadFix changelog",{"type":9,"value":6068,"toc":6307},[6069,6078,6082,6093,6097,6108,6112,6117,6121,6126,6130,6135,6139,6144,6148,6153,6157,6162,6166,6171,6175,6180,6184,6189,6193,6198,6202,6207,6211,6216,6220,6225,6229,6236,6240,6269,6273,6287,6289],[17,6070,6071,6072,6074,6075,6077],{},"Current version: 1.4.5. Updates for the 1.x line are free. Every date is in 2026. See the ",[86,6073,2192],{"href":949}," for the current feature list and ",[86,6076,5106],{"href":845}," for how to update.",[12,6079,6081],{"id":6080},"_145-9-november-2026","1.4.5 (9 November 2026)",[33,6083,6084,6090],{},[36,6085,6086,6087,6089],{},"Bridge to Quads: ",[28,6088,3766],{}," now continues the surface walls on either side instead of fairing the strip.",[36,6091,6092],{},"Bridge to Quads: the angle smoothing stays inside its own row and no longer depends on object scale.",[12,6094,6096],{"id":6095},"_144-9-november-2026","1.4.4 (9 November 2026)",[33,6098,6099,6105],{},[36,6100,6101,6102,6104],{},"New tool: ",[28,6103,761],{},". It joins two edge loops or two open chains with a strip of quads, even when the edge counts differ (up to 4 to 1). It has Auto Cuts, Cuts and Smoothness options.",[36,6106,6107],{},"The strip is more even around the reductions, and reduction rows are spread out.",[12,6109,6111],{"id":6110},"_143-8-november-2026","1.4.3 (8 November 2026)",[33,6113,6114],{},[36,6115,6116],{},"Clean & Quad leaves clean quads and the triangle fans at poles of spheres and cylinder caps alone, so a clean grid is not torn up.",[12,6118,6120],{"id":6119},"_142-8-november-2026","1.4.2 (8 November 2026)",[33,6122,6123],{},[36,6124,6125],{},"N-gons to Quads refills n-gons that came from a dissolved grid patch like a hole, which rebuilds the grid instead of giving a diamond pattern.",[12,6127,6129],{"id":6128},"_141-8-november-2026","1.4.1 (8 November 2026)",[33,6131,6132],{},[36,6133,6134],{},"Fill Holes splits notched, grid-shaped holes into rectangles and grid-fills each one.",[12,6136,6138],{"id":6137},"_140-8-november-2026","1.4.0 (8 November 2026)",[33,6140,6141],{},[36,6142,6143],{},"Union to Quads: a reduction row behind dense loops, and staircase teeth are kept.",[12,6145,6147],{"id":6146},"_135-8-november-2026","1.3.5 (8 November 2026)",[33,6149,6150],{},[36,6151,6152],{},"Union to Quads: back to the narrow seam strip with a lower cost for extra rings.",[12,6154,6156],{"id":6155},"_134-8-november-2026","1.3.4 (8 November 2026)",[33,6158,6159],{},[36,6160,6161],{},"Union to Quads: wider strips are preferred in seam crevices.",[12,6163,6165],{"id":6164},"_133-7-november-2026","1.3.3 (7 November 2026)",[33,6167,6168],{},[36,6169,6170],{},"Union to Quads keeps body creases sharp through the seam strip.",[12,6172,6174],{"id":6173},"_132-7-november-2026","1.3.2 (7 November 2026)",[33,6176,6177],{},[36,6178,6179],{},"Union to Quads absorbs differences in vertex count between the two sides with quad reductions.",[12,6181,6183],{"id":6182},"_131-31-october-2026","1.3.1 (31 October 2026)",[33,6185,6186],{},[36,6187,6188],{},"Union to Quads smooths the boundary loops of the strip along the seam.",[12,6190,6192],{"id":6191},"_130-7-october-2026","1.3.0 (7 October 2026)",[33,6194,6195],{},[36,6196,6197],{},"Union to Quads matches the two sides of the seam strip by arc length, giving fewer triangles and spikes.",[12,6199,6201],{"id":6200},"_126-125-and-124-5-october-2026","1.2.6, 1.2.5 and 1.2.4 (5 October 2026)",[33,6203,6204],{},[36,6205,6206],{},"A footer panel at the bottom of the QuadFix tab shows the version and the last result. These three releases fixed its position so it is always last.",[12,6208,6210],{"id":6209},"_123-5-october-2026","1.2.3 (5 October 2026)",[33,6212,6213],{},[36,6214,6215],{},"All tools are visible in both Object Mode and Edit Mode and are greyed out when the mode does not fit.",[12,6217,6219],{"id":6218},"_122-5-october-2026","1.2.2 (5 October 2026)",[33,6221,6222],{},[36,6223,6224],{},"Union to Quads rejects folded strips and prefers narrower, less sliver-like results when Rings is Auto.",[12,6226,6228],{"id":6227},"_120-october-2026","1.2.0 (October 2026)",[33,6230,6231],{},[36,6232,6101,6233,6235],{},[28,6234,785],{},". An exact Boolean union whose seam is rebuilt as a strip of quads, with Rings, Max Shape Change % and Keep Originals Hidden options.",[12,6237,6239],{"id":6238},"_118-to-110-27-and-28-september-2026","1.1.8 to 1.1.0 (27 and 28 September 2026)",[33,6241,6242,6245,6248,6251,6254,6257,6260,6263,6266],{},[36,6243,6244],{},"1.1.8: hole patches are faired smoothly onto the surface.",[36,6246,6247],{},"1.1.7: an automatic test suite on Blender 4.2, 4.5 and 5.2, and the fixes it found.",[36,6249,6250],{},"1.1.6: Clean & Quad converts faces created by its own dissolve in Face select mode.",[36,6252,6253],{},"1.1.5: wire edges left behind when a failed fill is reverted are removed.",[36,6255,6256],{},"1.1.4: round holes on curved surfaces are rebuilt properly.",[36,6258,6259],{},"1.1.3: Clean & Quad converts n-gons created by its own dissolve regardless of Keep Planar N-gons. Fill Holes matches triangle neighbourhoods.",[36,6261,6262],{},"1.1.2: grid growth works for all closed loops, and folded results are detected and reverted.",[36,6264,6265],{},"1.1.1: new vertices are relaxed onto the surface so patches bulge like their surroundings.",[36,6267,6268],{},"1.1.0: band-shaped holes are rebuilt by growing a quad grid across the gap.",[12,6270,6272],{"id":6271},"_109-to-100-27-september-2026","1.0.9 to 1.0.0 (27 September 2026)",[33,6274,6275,6278,6281,6284],{},[36,6276,6277],{},"1.0.9: grid rows follow the grid around the hole, and each piece of a split hole is filled separately.",[36,6279,6280],{},"1.0.8 to 1.0.3: better handling of long, band-like and horseshoe-shaped holes, with checks against sliver triangles and folded quads, and consistent normals with the neighbouring faces.",[36,6282,6283],{},"1.0.2: the version label appears in the panel.",[36,6285,6286],{},"1.0.0: first release with Fill Holes with Quads, N-gons to Quads and Clean & Quad.",[12,6288,1126],{"id":1125},[33,6290,6291,6295,6299],{},[36,6292,1131,6293],{},[86,6294,747],{"href":949},[36,6296,6297],{},[86,6298,370],{"href":835},[36,6300,1461,6301,305,6303,612,6305],{},[86,6302,1464],{"href":858},[86,6304,1467],{"href":865},[86,6306,1470],{"href":872},{"title":386,"searchDepth":387,"depth":387,"links":6308},[6309,6310,6311,6312,6313,6314,6315,6316,6317,6318,6319,6320,6321,6322,6323,6324,6325,6326,6327],{"id":6080,"depth":387,"text":6081},{"id":6095,"depth":387,"text":6096},{"id":6110,"depth":387,"text":6111},{"id":6119,"depth":387,"text":6120},{"id":6128,"depth":387,"text":6129},{"id":6137,"depth":387,"text":6138},{"id":6146,"depth":387,"text":6147},{"id":6155,"depth":387,"text":6156},{"id":6164,"depth":387,"text":6165},{"id":6173,"depth":387,"text":6174},{"id":6182,"depth":387,"text":6183},{"id":6191,"depth":387,"text":6192},{"id":6200,"depth":387,"text":6201},{"id":6209,"depth":387,"text":6210},{"id":6218,"depth":387,"text":6219},{"id":6227,"depth":387,"text":6228},{"id":6238,"depth":387,"text":6239},{"id":6271,"depth":387,"text":6272},{"id":1125,"depth":387,"text":1126},"Version history of the QuadFix Blender add-on from 1.0 to 1.4.5: new tools, hole-filling improvements, Union to Quads and Bridge to Quads changes.",{},"---\ntitle: \"QuadFix changelog\"\ndescription: \"Version history of the QuadFix Blender add-on from 1.0 to 1.4.5: new tools, hole-filling improvements, Union to Quads and Bridge to Quads changes.\"\naddon: quadfix\norder: 9\nupdated: 2026-11-16\n---\n\nCurrent version: 1.4.5. Updates for the 1.x line are free. Every date is in 2026. See the [product page](\u002Faddons\u002Fquadfix) for the current feature list and [install](\u002Fdocs\u002Fquadfix\u002Finstall) for how to update.\n\n## 1.4.5 (9 November 2026)\n\n- Bridge to Quads: **Smoothness** now continues the surface walls on either side instead of fairing the strip.\n- Bridge to Quads: the angle smoothing stays inside its own row and no longer depends on object scale.\n\n## 1.4.4 (9 November 2026)\n\n- New tool: **Bridge to Quads**. It joins two edge loops or two open chains with a strip of quads, even when the edge counts differ (up to 4 to 1). It has Auto Cuts, Cuts and Smoothness options.\n- The strip is more even around the reductions, and reduction rows are spread out.\n\n## 1.4.3 (8 November 2026)\n\n- Clean & Quad leaves clean quads and the triangle fans at poles of spheres and cylinder caps alone, so a clean grid is not torn up.\n\n## 1.4.2 (8 November 2026)\n\n- N-gons to Quads refills n-gons that came from a dissolved grid patch like a hole, which rebuilds the grid instead of giving a diamond pattern.\n\n## 1.4.1 (8 November 2026)\n\n- Fill Holes splits notched, grid-shaped holes into rectangles and grid-fills each one.\n\n## 1.4.0 (8 November 2026)\n\n- Union to Quads: a reduction row behind dense loops, and staircase teeth are kept.\n\n## 1.3.5 (8 November 2026)\n\n- Union to Quads: back to the narrow seam strip with a lower cost for extra rings.\n\n## 1.3.4 (8 November 2026)\n\n- Union to Quads: wider strips are preferred in seam crevices.\n\n## 1.3.3 (7 November 2026)\n\n- Union to Quads keeps body creases sharp through the seam strip.\n\n## 1.3.2 (7 November 2026)\n\n- Union to Quads absorbs differences in vertex count between the two sides with quad reductions.\n\n## 1.3.1 (31 October 2026)\n\n- Union to Quads smooths the boundary loops of the strip along the seam.\n\n## 1.3.0 (7 October 2026)\n\n- Union to Quads matches the two sides of the seam strip by arc length, giving fewer triangles and spikes.\n\n## 1.2.6, 1.2.5 and 1.2.4 (5 October 2026)\n\n- A footer panel at the bottom of the QuadFix tab shows the version and the last result. These three releases fixed its position so it is always last.\n\n## 1.2.3 (5 October 2026)\n\n- All tools are visible in both Object Mode and Edit Mode and are greyed out when the mode does not fit.\n\n## 1.2.2 (5 October 2026)\n\n- Union to Quads rejects folded strips and prefers narrower, less sliver-like results when Rings is Auto.\n\n## 1.2.0 (October 2026)\n\n- New tool: **Union to Quads**. An exact Boolean union whose seam is rebuilt as a strip of quads, with Rings, Max Shape Change % and Keep Originals Hidden options.\n\n## 1.1.8 to 1.1.0 (27 and 28 September 2026)\n\n- 1.1.8: hole patches are faired smoothly onto the surface.\n- 1.1.7: an automatic test suite on Blender 4.2, 4.5 and 5.2, and the fixes it found.\n- 1.1.6: Clean & Quad converts faces created by its own dissolve in Face select mode.\n- 1.1.5: wire edges left behind when a failed fill is reverted are removed.\n- 1.1.4: round holes on curved surfaces are rebuilt properly.\n- 1.1.3: Clean & Quad converts n-gons created by its own dissolve regardless of Keep Planar N-gons. Fill Holes matches triangle neighbourhoods.\n- 1.1.2: grid growth works for all closed loops, and folded results are detected and reverted.\n- 1.1.1: new vertices are relaxed onto the surface so patches bulge like their surroundings.\n- 1.1.0: band-shaped holes are rebuilt by growing a quad grid across the gap.\n\n## 1.0.9 to 1.0.0 (27 September 2026)\n\n- 1.0.9: grid rows follow the grid around the hole, and each piece of a split hole is filled separately.\n- 1.0.8 to 1.0.3: better handling of long, band-like and horseshoe-shaped holes, with checks against sliver triangles and folded quads, and consistent normals with the neighbouring faces.\n- 1.0.2: the version label appears in the panel.\n- 1.0.0: first release with Fill Holes with Quads, N-gons to Quads and Clean & Quad.\n\n## Related\n\n- Product page: [QuadFix](\u002Faddons\u002Fquadfix)\n- [Troubleshooting](\u002Fdocs\u002Fquadfix\u002Ftroubleshooting)\n- Guides: [fill a hole with quads](\u002Fguides\u002Ffill-hole-with-quads), [convert n-gons to quads](\u002Fguides\u002Fngons-to-quads) and [clean up an imported STL](\u002Fguides\u002Fclean-up-imported-stl)\n",{"title":6066,"description":6328},"docs\u002Fquadfix\u002Fchangelog","7arTMmN_Ib84b8873BVyFy7WGCCp5DrTO8K_LA5M6K4",1794858940884]