Blendkit logo
  • Download Blendkit
  • Subscribe
  • Mission
  • Users
    • FAQ
    • Terms & conditions
      • Terms and Conditions
      • Privacy Policy
      • Refund Policy
    • Get Blender add-ons
    • Blendkit beyond Blender
      • Blendkit for Godot
      • Blendkit for Rhino
      • Blendkit for Maya
      • Blendkit for Unreal
    • Add-on troubleshooting
    • Licenses
      • Lincenses info
      • Linceses FAQ
    • Service status
    • Cookies
      • Cookie Policy
      • Cookie settings
  • Creators
    • FAQ
    • Overview
    • Terms and Conditions for creators
    • General Uploading info
    • Upload Models
    • Upload Materials
    • Upload Brushes
    • Upload Add-ons
    • Guidelines for add-on creators
    • Upload Scenes
    • Upload HDRs
    • Upload Printables
    • Blender Tutorials
    • Validation Statuses
    • Fair Share Redistributions
    • Affiliate program
    • Most common upload issues
  • News
  • About
    • Our team
    • Contact
    • Press Kit
    • Blender 3D Training
    • Job positions
  • Models
  • Materials
  • HDRI
  • Scenes
  • Brushes
  • PrintablesNEW
  • Add-onsNEW
  • Log In
  • Register

BK BD 25

Blender 3D Mesh Add-Ons

Free Plan

Get 75,314 free assets

Full Plan 33% off

Access the full library & enjoy 154,728 assets

Blender add-ons 33% off

Find free & paid Blender add-ons

Become creator

Share & sell your assets

Built by 3D artists, for 3D artists. Meet Blendkit →

All assets

Add-ons icon Add-ons

  • Models icon Models
    • Architecture
      • Building
        • Commercial Historic Private Sci-fi
        • Other building
        Door Exterior element
        • Bench Facade element Fence Fountain Playground Swimming pool Urban Environment
        • Other exterior element
        Floor Covering Molding / Carving Scenes Stairs Structure Wall Panel
        • 3D Panel Stone Panel Upholstery Panel Wood Panel
        • Other wall panel
        Window
      • Other architecture
      Character
      • Anatomy
        • Full Body Head Internal organ Limbs Skeleton
        • Other anatomy
        Animal
        • Bird Dinosaur Fish Insect Mammal Reptile
        • Other animal
        Clothing
        • Accessories Footwear Headwear Lingerie Man Clothing Woman Clothing
        • Other clothing
        Humanoids
        • Child Fantasy Hero/ Heroines Medical Men Military Police Sci-Fi Sports Women
        • Other humanoids
        Monster / Creature Robot
      • Other character
      Decoration
      • Bag / Suitcase Blanket Book Carpets Clock / Watch Curtain Decoration Set Fabrics Fireplace Food / Drinks
        • Beverage Food Fruit / Vegetable Kitchenware Sweets / Dessert Tableware set
        • Other food / drinks
        Holiday Decoration Mirror Money Picture Pillow Sculpture Textile Vase Miscellaneous
      • Other decoration
      Effects / Simulations
      • Modifier Motion design Simulations Technical
      • Other effects / simulations
      Industrial
      • Container Equipment Machinery Parts Sign Tools
        • Handtools Powertools
        • Other tools
      • Other industrial
      Interior
      • Armchair Bathroom furniture
        • Accessories Bathhub Faucet Furniture Set Laundry Shower Toilet / Bidet Towel rail Wash Basin
        • Other bathroom furniture
        Bed Cabinets
        • Bookcase Commode Shelving TV Cabinets
        • Other cabinets
        Chair
        • Bar Chair Regular Chair
        • Other chair
        Console Dressing Table Kids furniture
        • Bed Chair Furniture Set Miscellaneous Table Toy Wardrobe
        • Other kids furniture
        Kitchen Furniture
        • Faucet Kitchen Appliance Kitchen Set Sink Storage
        • Other kitchen furniture
        Lights
        • Ceiling Light Floor Lamp IES Light Industrial Light Outdoor Light Table Lamp Wall Light
        • Other lights
        Office Furniture
        • Chair Desk Stationery Storage Table
        • Other office furniture
        Outdoor Furniture Pouf Restaurant / Bar Seating Set
        • Chair-table Set Sofa-table Set
        • Other seating set
        Shopping / Retail Sideboard / Drawers Chest Sofa Table Wardrobe
      • Other interior
      Military
      • Aircraft Vehicles Watercraft Weapon / Armor
        • Historic Modern Sci-Fi
        • Other weapon / armor
      • Other military
      Nature
      • Atmosphere
        • Cloud Fog Smoke / Fire Wind Setup
        • Other atmosphere
        Grass Landscape
        • Environment Elements Terrain
        • Other landscape
        Plant
        • Bouquet Fitowall Indoor Outdoor
        • Other plant
        Tree
      • Other nature
      Science
      • Lab Equipment Medical Equipment Microbiology Miscellaneous Pharmacy
      • Other science
      Space
      • Miscellaneous Planet Satellite Spacecraft Station
      • Other space
      Sport / Hobby
      • Fishing Gym Hobby Accessories Miscellaneous Music
        • Accessories Instruments Stage Studio
        • Other music
        Sport
      • Other sport / hobby
      Technology
      • Audio Devices Computer
        • Components / Hardware Desktop Game Console Keyboard Laptop Monitor Mouse Peripheral
        • Other computer
        Device
        • Cellular Phone Corded Phone Smartphone Smart Watch Tablet
        • Other device
        Home Appliance Miscellaneous Photography Robotics Video devices
      • Other technology
      Transport
      • Aircraft
        • Accessories / Part Air Baloon Airplane Drone Glider Helicopter Historic Plane Private Jet Seaplane
        • Other aircraft
        Bicycle Car
        • Buggy Concept Historical Luxury / Supercar Modern Racing Sci-Fi
        • Other car
        Emergency
        • Ambulance Fire trucks Police
        • Other emergency
        Heavy Vehicle
        • Industrial Trailer Truck Van
        • Other heavy vehicle
        Motocycle
        • Historical Race Standard
        • Other motocycle
        Public Transport
        • Bus Taxi
        • Other public transport
        Railed vehicle
        • Cargo Passenger
        • Other railed vehicle
        Small Electric Vehicles Vehicle Parts Watercraft
        • Accessories / Part Boat Hovercraft Ship Submarine Yacht
        • Other watercraft
      • Other transport
    • Other models
  • Materials icon Materials
    • Animal Asphalt Bricks Ceramic Concrete Dirt Fabric
      • Blackout Chenille Dimout Embroidery Flat weave Jacquard Print Sheer Suede Texture Velvet Vinyl / Imitation leather
      • Other fabric
      Floor Food Fx Glass Grass Ground Human Ice Leather Liquid Marble Metal Organic Ornaments Paper Paving Plaster Plastic Rock Roofing Rubber Rust Sand Soil Stone Tech Tiles Wood
    • Other materials
  • HDRIs icon HDRIs
    • Indoor
      • Abstract Futuristic Environments Holiday Industrial Interiors Nighttime Environments Public Residential Rural Sports Studio
      • Other indoor
      Outdoor
      • Abstract Architectural Cityscapes Futuristic Environments Holiday Landscapes Nature Nighttime Environments Sports Urban Water Environments
      • Other outdoor
    • Other hdris
  • Scenes icon Scenes
    • Abstract Cartoon Exterior
      • Architectural Nature Post-apocalyptic Private Public Rural Urban
      • Other exterior
      Gaming Industrial Interior
      • Creative studios
        • Photography Studios TV Studios YouTube/Podcast Studios
        • Other creative studios
        Interior Isometric Private Public
      • Other interior
      Product visualization
      • Cloth viz Mockup Studio
      • Other product visualization
      Science Templates
      • Background Brush templates Magazine cover Typography Validation scenes
      • Other templates
      Thematic Scenes
      • Fantasy Historical Holiday Sci-fi Space Underwater
      • Other thematic scenes
    • Other scenes
  • Brushes icon Brushes
    • Anatomy
      • Animal / creature
        • Claws Face / head Feather Fins Fur Limbs Organs Scales Scars & wounds Skeleton Skin Spikes Tails & horns
        • Other animal / creature
        Human
        • Body Face Hair & nails Muscles Organs Scars & wounds Skeleton Skin
        • Other human
      • Other anatomy
      Art
      • Pattern Sculpture
      • Other art
      Clothing
      • Accessories Fabric Stitches
      • Other clothing
      Damage
      • Concrete Crack Cut Dirt Glass Metal Plaster Rust Wood
      • Other damage
      Geometric Industrial
      • Hard surface Sci-fi
      • Other industrial
      Misc Nature
      • Crater Fire Ice Landscape Organic Plant Rock Soil Stone Wood
      • Other nature
    • Other brushes
  • Node Groups icon Node Groups
    • Compositing Nodes Geometry Nodes
      • Curves
        • Curve Deformers Curve Optimizers Curve Shapes
        • Other curves
        Distribution
        • Arrays Distribution Transform Surface Distribution Volumetric Distribution
        • Other distribution
        Generators
        • Animations Curve Generators Measurements Mesh Generators Voxel Generators
        • Other generators
        Material
        • Colors
        Math
        • Functions Interpolations
        Selection
        • Falloffs Select by
        • Other selection
        Simulation
        • Diffusions Particle Physics
        • Other simulation
        Tools
        • Edit / Object mode
        • Other tools
        Topology
        • Mesh Deformers Mesh Primitives Remeshers Tessellate Mesh
        • Other topology
        Utilities
        • Rotation Switches Text / String Tools UV Vector Fields Visualizers
        • Other utilities
      • Other geometry nodes
      Shading Nodes
      • Effects Procedural Textures
      • Other shading nodes
  • Printables icon Printables
    • Containers Fashion Games Holders Instruments Mechanics Misc Organics
    • Other printables
  • Add-ons icon Add-ons
    • 3D View Add Mesh Animation Development General Import - Export Material Mesh Modeling Node Object Paint Render Rigging Scene System Tools User Interface UV
  • Creators icon Creators
  • Creations icon Creations
YouTube Facebook Instagram GitHub TikTok BlueSky Mastodon
  • Trending  
  • Most bookmarked  
  • Highest asset score  
  • Highest complexity  
  • Highest quality  
  • Asset count  
  • Asset score sum
  • Newest
  • Most relevant
  • All
  • Free
  • Full
  • Paid
  • All assets
  • My bookmarked assets
  • All
  • 0 - 999
  • 1,000 - 9,999
  • 10,000 - 99,999
  • 100,000 - 999,999
  • 1,000,000 and more
  • All
  • Less than 256
  • 256
  • 512
  • 1K
  • 2K
  • 4K
  • 8K
  • 16K and more
  • All
  • Sculpt
  • Texture paint
  • All
  • Procedural
  • Texture based
  • All
  • Realistic
  • Non photorealistic
  • Other
  • All
  • Yes
  • No
  • All
  • Geometry nodes
  • All
  • Yes
  • No
  • All
  • Yes
  • No
  • All
  • No Sexualized Content
  • Sexualized Content
  • All
  • Yes
  • No
  • All
  • Windows
  • MacOS
  • Linux
  Bookmarks
The asset was added to your bookmarks.
Now you can filter it in Blendkit add-on.
  Bookmarks
The asset was removed from your bookmarks
  Bookmarks
Your rating could not be saved. Please try again.

QuadFix - Quad Fill, Clean & Boolean Prep

add-on add-on

Fill holes with quads, n-gons to quads, clean boolean results

$12 $8.04
Share on Twitter Share on Facebook Share on Reddit Share link
QuadFix 1.4.5: user manual

Manual for QuadFix 1.4.5 (Blender add-on). Trailer: https://youtu.be/h_6LSHC6sQY

Buy: Superhive | Gumroad | Free Lite version: GitHub

Contents: 1 What it does | 2 Install | 3 Quick start | 4 Reference | 5 Worked examples | 6 Troubleshooting | 7 Limitations | 8 Glossary | 9 FAQ | 10 Support and changelog


1. What it does

QuadFix repairs meshes in Blender. It closes holes with a grid of four-sided faces (quads), turns triangles and curved n-gons into quads, cleans up the mess a Boolean cut or an import leaves behind, bridges two edge loops with a clean strip of quads, and joins overlapping objects with a tidy quad seam. Select the problem, press one button, read the result in the panel.

Who it is for

  • Game artists who clean up imported or AI-generated meshes (Meshy, Tripo, Hunyuan3D) before UV unwrapping or baking.
  • Hard-surface modelers who need clean topology after Boolean cuts.
  • 3D-print and CAD users who repair STL/OBJ imports and scans.
  • Anyone who finds that Blender's Tris to Quads and Grid Fill do not finish the job.

What it is not. QuadFix repairs the mesh you already have. It is not an automatic retopology tool (it does not rebuild the whole edge flow like a remesher).


2. Requirements and installation

Requirements

  • Blender 4.2 or newer (4.2 LTS, 4.5 LTS and 5.x). It is a Blender extension.
  • No internet, no extra software, no compiled files. It uses Blender's own bmesh.
  • The add-on is a .zip file. Do not unzip it.

Install from disk

  1. In Blender open Edit > Preferences (on Mac: Blender > Settings also works, or press Cmd+,).
  2. Click Get Extensions in the left list.
  3. Click the small arrow (v) menu in the top-right corner of the window and choose Install from Disk...
  4. Pick the QuadFix .zip file and confirm. On older 4.2 builds a short "online access" notice may appear; QuadFix itself never uses the internet.
  5. The extension is added and turned on. If you see it in the list with an unchecked box, tick the box to enable it.

Where is the panel?

  1. Move the mouse over the 3D viewport (the big window with your model).
  2. Press N to open the sidebar (a panel on the right edge). Press N again to close it.
  3. Click the tab named QuadFix (the tabs are written vertically at the right edge of the sidebar).
  4. The tab holds three panels: QuadFix (the mesh tools), Union (Object Mode) and a footer called QuadFix v1.4.5 that shows the last result.

Most tools need Edit Mode (select a mesh, press Tab). Union to Quads needs Object Mode. The buttons that do not fit the current mode stay visible but greyed out, with a hint at the top of the panel ("Edit Mode tools: press Tab" or "Object Mode tool: press Tab"). The panel is hidden in other modes such as Sculpt.

Update to a new version

  1. Download the new zip.
  2. Do the same Install from Disk steps. Blender replaces the old version with the new one.
  3. If the panel still shows the old version number in the footer, restart Blender.

Your settings are stored per scene (in the .blend file), so open files keep their option values.

Uninstall

Edit > Preferences > Get Extensions, find QuadFix in the list, open the arrow next to it and choose Uninstall (or remove it with the dropdown menu). Your models are not changed. Meshes that you already fixed stay fixed.

Lite or full?

| | QuadFix Lite (free, GPL) | QuadFix (full) |
|---|---|---|
| Panel tab name | QuadFix Lite | QuadFix |
| N-gons to Quads | yes | yes |
| Clean & Quad (Boolean Prep) | yes | yes |
| Select Non-Quads & Holes | yes | yes |
| Fill Holes with Quads (+ Grid Span, Match Triangle Meshes) | no | yes |
| Bridge to Quads | no | yes |
| Union to Quads | no | yes |

Lite and full can be installed side by side because the tabs have different names. This manual covers the full version; Lite has the three tools marked "yes".


3. Quick start

Try it on a Blender sphere with a few faces deleted.

  1. Add a sphere (Add > Mesh > UV Sphere). Press Tab to enter Edit Mode.
  2. Switch to Face select mode (press 3), select a few faces and press X > Faces to make a hole.
  3. Press N, open the QuadFix tab. Press A to select everything (QuadFix only touches the selection by default).
  4. Press Select Non-Quads & Holes. The footer says, for example, "12 non-quad faces, 9 boundary edges". That is what needs fixing.
  5. Press A again to select everything, then press Fill Holes with Quads. The footer reads "Filled 1 loop(s). Now: ... quads / ... tris / ... n-gons". Undo with Cmd+Z (Mac) or Ctrl+Z (Windows/Linux) if you do not like it.


4. Reference: every panel, button and setting

The panels appear in this order. A report line is the text in the footer panel (and in Blender's status bar). Every tool except Select Non-Quads & Holes can be undone with one Cmd/Ctrl+Z.

4.1 Panel "QuadFix" (Edit Mode)

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| Only Selected (checkbox) | On: tools work only on the selected geometry. Off: tools work on the whole mesh. | Leave on to fix one area without touching the rest. Turn off to fix everything without selecting. | On |
| Select Non-Quads & Holes (button) | Clears the selection, then selects every triangle and n-gon and every open boundary edge. Writes "N non-quad faces, M boundary edges" in the footer. | First step: shows what is left to fix. Run it again after fixing to see that the numbers dropped. | - |

A boundary edge is an edge that has a face on only one side, the border of a hole.

4.2 Box "Holes"

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| Fill Holes with Quads (button) | Closes every closed boundary loop (hole) that is fully selected with a quad grid that continues the surrounding faces. Handles odd-sized loops, irregular holes, notched holes and band-shaped gaps. | Holes from deleted faces, scan holes, ripped game models. | - |
| Grid Span | The span value passed to Blender's grid fill (how many columns the grid uses). 0 lets QuadFix choose. | Leave at 0. Try 1, 2, 3 only if the automatic grid looks too coarse or too fine. | 0, whole numbers from 0 up |
| Match Triangle Meshes (checkbox) | If most of the faces around the hole are triangles (a typical scan), the patch is kept triangular too, so it does not look out of place. | Keep on for scans and triangulated meshes. Turn off if you want quads in the patch whatever the surroundings are. | On |

Selection rules for Fill Holes (important):

  • A hole is only filled when all of its edges are selected (with Only Selected on). A half-selected hole is skipped and counted in the report.
  • The outer border of a flat open sheet (a plane, terrain, cloth) is skipped on purpose: it is not a hole. The report says "N outer border(s) skipped".
  • Every other closed boundary loop is filled, including openings you may not think of as holes (the eye sockets of a Suzanne monkey).
4.3 Box "Bridge"

The box shows the hint "Select two edge loops or chains".

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| Bridge to Quads (button) | Builds a strip of quads between exactly two selected edge loops (closed rings) or two open edge chains. Loops with different numbers of edges are matched with quad "reductions" (up to 4:1). The result is checked for folds, twists and self-intersections and is taken back completely if a check fails. | Connecting two holes (like a handle or a pipe joint), closing a gap between two rims, joining the end of a tube to another tube. | - |
| Auto Cuts (in "Adjust Last Operation") | Adds loops between the two sides so the quads come out about square. | Leave on. | On |
| Cuts (in "Adjust Last Operation") | Number of extra loops between the two sides. Only active when Auto Cuts is off. | When you want a fixed number of rows. If the ratio needs more rows, QuadFix raises it and says so. | 0, range 0 to 64 |
| Smoothness (in "Adjust Last Operation") | 0 = straight rows between the two sides. 1 = the rows follow the curvature of the surface around them. | 0 for tubes and straight connections. Raise it when the two sides are tilted against each other, or to continue a curved surface. If the curved version fails the checks, QuadFix falls back to straight and tells you. | 0.0, range 0.0 to 1.0 |

Where do the three options appear? They are not in the QuadFix tab. After you press Bridge to Quads, a small panel called Bridge to Quads opens at the bottom-left of the 3D viewport. If you cannot see it, use Edit > Adjust Last Operation (shortcut F9; on a Mac laptop you may need Fn+F9). Change a value and the result updates; the settings are remembered for the next bridge.

Selection rules for Bridge:

  • Use Edge select mode (press 2). In Vertex select mode, QuadFix ignores the inner edges and uses only open edges.
  • Select exactly two separate loops or chains, both closed or both open. Edges must be open (boundary or wire edges), not edges that already have faces on both sides.
  • Both sides need at least 3 edges when closed. A three-edge loop usually cannot take a quad strip; close it with Fill Holes instead.
  • If the total number of edges on the two sides is odd, one triangle is unavoidable. It is selected together with the strip.
4.4 Box "Quads"

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| N-gons to Quads (button) | Converts selected triangles and n-gons to quads. Curved n-gons are triangulated and joined again. Large grid-shaped n-gons (a dissolved patch of a grid) are opened like a hole and refilled with a proper grid. | After a Boolean, after dissolving edges, on triangulated imports. | - |
| Face Angle | The largest angle allowed between the normals (facing directions) of two triangles that are joined into a quad. | Raise it to join more triangles across curved areas (scans). Lower it to keep creases. | 90 degrees, range 0 to 180 |
| Shape Angle | How far a new quad may differ from a perfect rectangle. | Raise it to get more quads from messy triangles. Lower it for regular quads. | 90 degrees, range 0 to 180 |
| Keep Planar N-gons (checkbox) | Leaves flat n-gons (clean CAD faces, caps) untouched. Only curved n-gons and triangles are converted. | Keep on for CAD and hard-surface parts. Turn off for scans, where flat n-gons are noise. | On |
| Aggressive Quads (checkbox) | Joins any two triangles into a quad whatever the angles. Fewest triangles left, but less regular quads. | When you prefer "no triangles" over "nice shapes". | Off |

If everything selected is already quads (or flat n-gons with Keep Planar N-gons on) the button says "Nothing to convert (all quads or flat n-gons)". Report line: "n-gons A->B, tris C->D, quads E->F".

4.5 Box "Boolean / Import Cleanup"

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| Clean & Quad (Boolean Prep) (button) | One click: merge doubles, remove degenerate and loose geometry, limited dissolve (removes extra edges on flat areas, only around triangles and n-gons), converts leftover triangles and n-gons to quads, recalculates normals. Clean quads and pole caps (the triangle fan at a sphere pole) are left alone. | After a Boolean cut or after importing STL, OBJ, FBX, CAD or scan data. | - |
| Merge Distance | Vertices closer than this are merged (a "double" is two vertices at the same place). Also used for removing degenerate geometry. Units are Blender units. | Raise slightly for imports with tiny gaps. Keep tiny for precise models. | 0.0001, minimum 0 |
| Dissolve Angle | Edges between faces that are flatter than this angle are removed. | Raise to simplify more. Lower to keep gentle curves. | 5 degrees, range 0 to 90 |
| Keep Sharp Edges (checkbox) | Never dissolves edges marked sharp or as seams. | Keep on if you marked edges for shading or UV seams. | On |

Clean & Quad also uses Face Angle, Shape Angle, Aggressive Quads and Keep Planar N-gons from the Quads box. Report line: "verts A->B, quads ..., tris ..., n-gons ...".

4.6 Panel "Union (Object Mode)"

| Control | What it does | When to use it | Default / range |
|---|---|---|---|
| Union to Quads (button) | Merges the selected objects into the active one with an exact Boolean union, then rebuilds the seam (the line where the shapes meet) as a strip of quads instead of triangles and n-gons. Needs Object Mode, at least two selected meshes, and an active mesh. | Joining a sphere and a cylinder, a handle to a body, any two overlapping closed meshes. | - |
| Rings (in "Adjust Last Operation") | How many face rings around the seam are rebuilt: Auto, 1, 2 or 3. Auto tries 1 to 3 and keeps the cleanest. | Leave on Auto. | Auto |
| Max Shape Change % | Safety limit. A rebuilt strip that would move the surface by more than this percentage of the object size is rejected and that seam stays a plain Boolean. | Raise it if many seams were "left as plain boolean". Lower it for stricter shape. | 2.0, range 0.1 to 20 |
| Keep Originals Hidden (checkbox) | Hides the other objects instead of deleting them. | Keep on. To get them back use Object > Show/Hide > Reveal Hidden (Alt+H). | On |

How to use: click the object you want to keep last (it becomes the active, brightest-outlined object), Shift-click the others, press Union to Quads. The active object receives the new mesh (the mesh is renamed with the ending _union). Materials of all objects are kept. The options live in Edit > Adjust Last Operation (F9).

Report line: "Union: N seam loop(s) rebuilt, M left as plain boolean. Mesh: quads A, tris B, n-gons C".

4.7 Footer panel "QuadFix v1.4.5"

Shows the report line of the last tool ("Last result: none yet" at start) and the version. Click the header to fold it.


5. Worked examples Example 1: Close a hole in a sphere
  1. Create a UV sphere, delete a few neighbouring faces in Edit Mode (Face select mode, X > Faces).
  2. Press N, tab QuadFix. Press A (select all).
  3. Press Fill Holes with Quads.
  4. Look at the result with Select Non-Quads & Holes: the boundary edge count is 0.


Tip: a tilted band cut out of the sphere is rebuilt the same way.

Example 2: Clean up after a Boolean cut
  1. Cut a shape out of a cube with the Boolean modifier and Apply the modifier (Object > Apply > Visual Geometry to Mesh or the modifier's dropdown > Apply).
  2. Go to Edit Mode, press A.
  3. Press Clean & Quad (Boolean Prep).
  4. Check the footer: triangles and n-gons should drop. Press Select Non-Quads & Holes to see what is left.


Example 3: Triangulated scan to quads
  1. Import the scan. Enter Edit Mode, press A.
  2. Turn Keep Planar N-gons off (scans have no meaningful flat n-gons).
  3. Press N-gons to Quads. Red faces in the solid-shading overlay are triangles left over; some are unavoidable on very irregular scans.
  4. If too many triangles remain, raise Face Angle and Shape Angle a little or turn on Aggressive Quads, undo, and press again.


Example 4: Bridge two loops with quads
  1. Make two open rings facing each other (for example two cylinders with the end caps deleted, or a hole in a wall and the open end of a pipe).
  2. Edge select mode (2). Select the first ring (Alt+click an edge selects a loop). Shift+Alt+click selects the second ring.
  3. Press Bridge to Quads. The report says how many quads, rows and reductions were made.
  4. Open Edit > Adjust Last Operation and try Smoothness 0.5 if the rings are tilted.

Example 5: Union of two objects with a quad seam
  1. Object Mode. Place a sphere and a cylinder so they overlap.
  2. Click the cylinder, Shift-click the sphere last (the sphere is active and will be kept).
  3. Press Union to Quads in the Union (Object Mode) panel.
  4. The sphere object now holds the joined mesh; the cylinder is hidden (Alt+H brings it back).


6. Troubleshooting 6.1 Panel and buttons

| Symptom | Cause | Fix |
|---|---|---|
| I do not see the QuadFix tab | The sidebar is closed, the mouse is not over the 3D viewport, or you are in a mode other than Object/Edit Mode. | Hover over the viewport, press N, look for the vertical tab named QuadFix. Return to Object or Edit Mode. |
| The buttons are greyed out | The tool does not fit the mode. Mesh tools need Edit Mode, Union needs Object Mode. | Press Tab. The panel says "Edit Mode tools: press Tab" or "Object Mode tool: press Tab". |
| Union is still greyed out in Object Mode | Fewer than two selected meshes, or the active object is not a mesh. | Select two or more mesh objects and make one of them active. |
| Nothing visible happens | The result may be small. | Look at the footer report line. |

6.2 Messages you can see

| Message | Where | Meaning and fix |
|---|---|---|
| "No boundary edges (holes) in selection" | Fill Holes | Nothing selected is on a hole. Select the hole edges, or turn off Only Selected. |
| "Nothing to fill: N outer border(s), M partly selected hole(s)" | Fill Holes | The only loops found were the outer rim of an open sheet (skipped on purpose) or holes that are only partly selected. Select the whole hole loop. |
| "No holes" | Fill Holes | No usable hole was found in the selection. |
| "Filled N loop(s) (X outer border(s) skipped, Y partly selected hole(s) skipped). Now: Q quads / T tris / G n-gons" | Fill Holes | Success. The notes tell what was skipped. |
| "Nothing to convert (all quads or flat n-gons)" | N-gons to Quads | The selection has no triangles or curved n-gons. Turn off Keep Planar N-gons if you want flat n-gons converted. |
| "N non-quad faces, M boundary edges" | Select Non-Quads & Holes | Information. The faces and edges are selected for you. |
| "Bridge: select two edge loops or open edge chains (Edge select mode)" | Bridge | Nothing usable is selected. |
| "Bridge: N selected edge(s) already have faces on both sides: select open (boundary) edges" | Bridge | You selected inner edges. Select only the open rims. They are highlighted. |
| "Bridge: the selection branches at N vertex(es): select two simple loops or chains" | Bridge | A selected loop splits into branches. Select simple rings. |
| "Bridge: only one loop or chain is selected: select two (a single hole is closed by Fill Holes)" | Bridge | Select a second loop, or use Fill Holes for a single hole. |
| "Bridge: N separate loops or chains are selected: select exactly two" | Bridge | Deselect the extras. |
| "Bridge: a selected loop touches itself: select two simple loops or chains" | Bridge | The loop crosses or touches itself (figure eight). Select simple loops. |
| "Bridge: one side is a closed loop and the other an open chain: select two loops or two chains" | Bridge | Both sides must be the same kind. |
| "Bridge: a loop needs at least three edges" | Bridge | A closed loop of one or two edges cannot be bridged. |
| "Bridge: the two sides have A and B edges (R:1): at most 4:1 can be bridged with quads" | Bridge | One side has more than four times the edges of the other. Add edges to the small side (subdivide it) or fill part of the large side. |
| "Bridge: the two sides face opposite ways (recalculate their normals first: Mesh > Normals > Recalculate Outside)" | Bridge | Flipped normals. Fix them and try again. |
| "Bridge: a selected loop or chain has no length (...Merge by Distance)" | Bridge | Vertices sit on top of each other. Use Mesh > Clean Up > Merge by Distance. |
| "Bridge: no quad layout for A against B edges in N row(s): add cuts" | Bridge | Turn off Auto Cuts and raise Cuts, or turn Auto Cuts back on. |
| "Bridge: the two sides are already connected by faces" | Bridge | The loops are already joined. |
| "Bridge: a loop of three edges can not take a quad strip ... a triangular rim is better closed with Fill Holes" | Bridge | Use Fill Holes. |
| "Bridge: the strip folds / twists / ..." (the check that failed) | Bridge | The result was taken back; the mesh is unchanged. Move or rotate the loops, change Smoothness, or add Cuts. |
| "... (switched to Edge select mode to show the edges)" | Bridge | QuadFix changed to Edge select mode so you can see the problem edges. |
| "Bridge: N quads between A and B edges, R row(s), X reduction(s)" | Bridge | Success. |
| "... A+B edges in total is odd: one triangle is unavoidable (selected with the strip)" | Bridge | Normal. One triangle remains. |
| "... Cuts raised to N: R:1 needs M reduction rows" | Bridge | You set Cuts too low for the edge ratio, so QuadFix raised it. |
| "... Smoothness was dropped: following the surface ..." | Bridge | The curved strip failed the checks, so the straight strip was used. |
| "Boolean union produced no faces. Are both meshes closed and do they overlap?" | Union | Meshes with holes or no overlap cannot be unioned. Close holes first (Fill Holes) and make sure the objects overlap. |
| "The objects do not intersect: nothing was changed" | Union | The objects only touch or are apart. Move them so they overlap. |
| "Union: N seam loop(s) rebuilt, M left as plain boolean. Mesh: ..." | Union | If M is more than 0, those seams were too tricky or would change the shape more than Max Shape Change %. They stay as an ordinary Boolean seam. |

6.3 Results that look wrong

| Symptom | Cause | Fix |
|---|---|---|
| Fill Holes did nothing to one hole | The hole is partly selected, or it is the outer border of a flat sheet. | Select the complete loop. Use Select > Select Loops > Select Boundary Loop if needed. |
| Fill Holes also filled something I did not want filled | Every fully selected closed boundary is filled (eye sockets, mouth). | Select only the loops you want, or undo and deselect them. |
| Leftover triangles after N-gons to Quads | Irregular scans have regions that cannot become quads. | Raise Face/Shape Angle, or try Aggressive Quads. A few triangles are normal. |
| Union leaves seams as plain Boolean | The strip would move the surface more than allowed, or the seam runs through a hole. | Raise Max Shape Change %, close holes first, or use similar mesh density on both objects. |
| Union result zig-zags | Objects have very different mesh density. | Make densities similar (subdivide or decimate one object). |
| The original objects vanished after Union | They are hidden (not deleted). | Alt+H in Object Mode, or Object > Show/Hide > Reveal Hidden. |
| Slow on a big mesh | Pure Python tools. | Select only the area to fix. QuadFix was tested up to 200,000 faces; very dense meshes take longer. |
| I want to undo | | Cmd+Z / Ctrl+Z. One step per tool. |


7. Known limitations
  • QuadFix repairs the mesh you have. It does not rebuild edge flow like an auto-retopology tool.
  • Some triangles are unavoidable on very irregular scans.
  • Fill Holes fills every fully selected closed boundary loop and skips the outer border of flat open sheets and half-selected holes.
  • Bridge needs exactly two simple loops or chains of the same kind, with an edge ratio of at most 4:1. A three-edge loop is better closed with Fill Holes. An odd total of edges leaves one triangle.
  • Union to Quads rebuilds seams only. The new strip gets no UV coordinates. Seams that run through holes in the input stay a plain Boolean. On dense meshes with very different density on both sides the strip is all quads but zig-zags.
  • Union works on the mesh data of the objects. If you rely on modifiers, apply them first (they are not part of the union).
  • Not tested on Windows or Linux (see section 10).
  • The tools do not create or preserve UV seams for the newly created faces beyond what Blender's operators keep. Check UVs after heavy edits.

8. Glossary
  • Quad: a face with four corners. Quads deform and subdivide well.
  • Triangle (tri): a face with three corners.
  • N-gon: a face with more than four corners.
  • Triangle soup: a mesh made only of triangles in a messy layout (typical for scans and AI meshes).
  • Boundary edge / hole: an edge that has a face on only one side. A closed loop of them is a hole.
  • Edge loop / chain: a ring (loop) or an open line (chain) of connected edges.
  • Boolean: cutting or joining shapes with the Boolean modifier. It leaves triangles and n-gons at the seam.
  • Seam (here): the line where two objects intersect.
  • Normal: the direction a face points. Flipped normals face inside.
  • Planar: flat. A planar n-gon lies in one plane.
  • Pole: a vertex where many edges meet, such as the top of a UV sphere.
  • Manifold / non-manifold: a manifold mesh is a clean closed surface. Non-manifold meshes have holes, loose edges or edges shared by more than two faces.
  • Merge by distance: merging vertices that sit almost in the same place.
  • Limited dissolve: removing edges between nearly flat faces.
  • Retopology: rebuilding a mesh with a new clean layout.
  • UV: the 2D coordinates used to put a texture on a mesh.

9. FAQ

Why does Blender's Grid Fill fail on my hole? It needs a closed loop with an even number of edges. Fill Holes with Quads handles odd loops and irregular outlines.

Why does Tris to Quads (Alt+J) not convert all triangles? It only joins neighbouring pairs within its angle limits and ignores n-gons. N-gons to Quads triangulates curved n-gons first and lets you set the angles.

Is it a retopology tool or a remesher? No. It repairs what is there.

Can I use it on AI meshes from Meshy, Tripo or Hunyuan3D? Yes for holes, doubles, triangle soup and a report of what is left. It will not rebuild edge flow.

Does it work on Blender 5.x? On Windows and Linux? Tested on Blender 4.2.23, 4.5.14 and 5.2.2 on macOS. It is pure Python and should run anywhere Blender runs, but Windows and Linux are not tested by me.

Does it need the internet? No.

Is it undo-safe? Yes, one Cmd/Ctrl+Z undoes one button press.

Does it keep UVs, materials, vertex groups, shape keys? The tools edit the mesh with Blender's bmesh functions. New faces get no new UV data from QuadFix itself, and Union to Quads gives no UVs to the new strip. Materials are kept by Union. Check anything beyond that on a copy of your file first.

Can I use it on a whole mesh without selecting? Yes: turn off Only Selected.

Do I get updates? Free updates for the 1.x line.

What is the difference between Lite and full? See the table in section 2.

Can I get a refund? Refunds follow the store policy of where you bought it (Superhive or Gumroad). Write to support first if something does not work.


10. Support, compatibility and changelog

Support: [email protected]. Include your Blender version, your operating system, the report line from the footer (copy the text), and, if possible, a small .blend file that shows the problem.

Compatibility, as tested: the automated test suite passes on Blender 4.2.23, 4.5.14 and 5.2.2 on macOS. It runs each tool under vertex, edge and face select modes, with partial selections, checks undo, and includes a 200,000-face performance case. Windows and Linux were not tested.

License: GPL-3.0-or-later.

Changelog (dates are the commit dates of the tags; versions before 1.1.8 were development builds)

| Version | Date | Change |
|---|---|---|
| 1.4.5 | 2026-11-09 | Bridge to Quads: refits side B against the nearest points of side A; Smoothness continues the walls |
| 1.4.4 | 2026-11-09 | Bridge to Quads: angle smoothing stays inside its row, scale-free |
| 1.4.3 | 2026-11-08 | Clean & Quad leaves clean quads and pole caps alone |
| 1.4.2 | 2026-11-08 | N-gons to Quads refills grid-shaped n-gons like a hole |
| 1.4.1 | 2026-11-08 | Fill Holes splits notched grid holes into rectangles |
| 1.4.0 | 2026-11-08 | Union: reduction row behind dense loops, keeps staircase teeth |
| 1.3.5 | 2026-11-08 | Union: back to the narrow strip |
| 1.3.4 | 2026-11-08 | Union: wide strips win in seam crevices |
| 1.3.3 | 2026-11-07 | Union keeps body creases sharp through the strip |
| 1.3.2 | 2026-11-07 | Union absorbs vertex-count differences with quad reductions |
| 1.3.1 | 2026-10-31 | Union smooths the strip boundary loops along the seam |
| 1.3.0 | 2026-10-07 | Union seam strip matched by arc length |
| 1.2.6 | 2026-10-05 | Footer panel sorts last |
| 1.2.5, 1.2.4 | 2026-10-05 | Version and last result in a bottom panel |
| 1.2.3 | 2026-10-05 | All tools visible in both modes, greyed out when the mode does not fit |
| 1.2.2 | 2026-10-05 | Union to Quads: rejects folded strips; width and sliver penalty in Auto rings |
| 1.1.8 | 2026-09-28 | Smoother (biharmonic) hole patches. First public release |
| 1.1.7 | 2026-09-28 | Automated test suite on Blender 4.2/4.5/5.2 and the fixes it found |
| 1.1.6 | 2026-09-28 | Clean & Quad converts dissolve-created faces in face select mode |
| 1.1.5 | 2026-09-28 | Removes wire edges left after a reverted grid growth |
| 1.1.4 | 2026-09-28 | Grid rebuild of round holes on curved surfaces |
| 1.1.3 | 2026-09-28 | Clean converts dissolve-created n-gons; Fill matches triangle neighbourhoods |
| 1.1.2 | 2026-09-28 | Grid growth for all closed loops; fold detection reverts bad fills |
| 1.1.1 | 2026-09-28 | New grid vertices relaxed onto the surface |
| 1.1.0 | 2026-09-28 | Grid reconstruction for band holes |
| 1.0.0 to 1.0.9 | 2026-09-27 | First builds: Fill Holes, N-gons to Quads, Clean & Quad, Select Non-Quads & Holes |

By

Author avatar Mendbox Studio

File size

119.7 KiB

Version

1.4.5

Platforms

windows-x64, macos-arm64, linux-x64, macos-x64, windows-arm64

Minimal required Blender version

4.2.0

QuadFix - Quad Fill, Clean & Boolean Prep

add-on QuadFix - Quad Fill, Clean & Boolean Prep

AnyHole Pro: Interactive Boolean Cutter
Free

add-on AnyHole Pro: Interactive Boolean Cutter

21
Quick Groups (Instances)
Free

add-on Quick Groups (Instances)

15
Instant Clean - The Ultimate Mesh Clean

add-on Instant Clean - The Ultimate Mesh Clean

12
Dimensions and Lines

add-on Dimensions and Lines

11
Smart Remesh

add-on Smart Remesh

11
Live Cut

add-on Live Cut

10
Set to wire Boolean Blender 5.2 mesh bevel
Free

add-on Set to wire Boolean Blender 5.2 mesh bevel

9
Object Flipper
Free

add-on Object Flipper

9
Delete Loose V2
Free

add-on Delete Loose V2

5
Raster Crafter v1.3.3
Free

add-on Raster Crafter v1.3.3

4
Pro Aligner - Align Any Object With A Click

add-on Pro Aligner - Align Any Object With A Click

3
Anime Outline

add-on Anime Outline

3
Smart Normal Fixer
Free

add-on Smart Normal Fixer

3
Easy Bake + Batch Baking

add-on Easy Bake + Batch Baking

2
Section Pro - Sections, Projections & Technical Drawings

add-on Section Pro - Sections, Projections & Technical Drawings

2
Fill Holes
Free

add-on Fill Holes

2
Smart Segmentation

add-on Smart Segmentation

2
DamageCraft — Edge Chips & Surface Wear

add-on DamageCraft — Edge Chips & Surface Wear

2
Cloud Atelier — Mesh-to-Cloud for Blender & VDB Clouds, Fog

add-on Cloud Atelier — Mesh-to-Cloud for Blender & VDB Clouds, Fog

2
LOD Generator Pro - Ultimate Edition

add-on LOD Generator Pro - Ultimate Edition

1
Greaseliner

add-on Greaseliner

1
Rift Tools — Editable Cracks & 14 Glass Fracture Patterns for Blender

add-on Rift Tools — Editable Cracks & 14 Glass Fracture Patterns for Blender

1
QuadFix Lite - N-gons to Quads and Mesh Cleanup
Free

add-on QuadFix Lite - N-gons to Quads and Mesh Cleanup

1
Star Connect - Smart Mesh Triangulation

add-on Star Connect - Smart Mesh Triangulation

  • «
  • 1
  • 2
  • 3
  • …
  • 18
  • 19
  • 20
  • »
Added To Cart
To complete your purchase or update it, please go to cart. If you want to find more awesome add-ons, continue to explore.
Go to Cart
Already Purchased
You already purchased this item. It is impossible to buy it again. Continue to explore and enjoy :-)
My Orders