# QuadFix troubleshooting: errors and fixes

> 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.

- Page: https://mendboxstudio.com/docs/quadfix/troubleshooting
- Updated: 2026-11-16
- Publisher: Mendbox Studio (Dynamic Flower Unipessoal LDA, Portugal)

Messages quoted below are the ones QuadFix shows in the panel footer and in Blender's status bar. Options are explained in the [panel reference](https://mendboxstudio.com/docs/quadfix/panel).

## Why are the QuadFix buttons greyed out?

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 `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.

## Why does Fill Holes say "No boundary edges (holes) in selection"?

Fill 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.

## Why does Fill Holes say "Nothing to fill"?

The 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.

## Why was one of my holes skipped?

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 `1 partly selected hole(s) skipped`. Fix the selection and run the tool again.

## Why did Fill Holes close an opening I wanted open?

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.

## Why does the patch have triangles instead of quads?

If 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.

## Why does Bridge to Quads say "select two edge loops or open edge chains (Edge select mode)"?

Nothing 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.

## Why does Bridge to Quads say selected edges "already have faces on both sides"?

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.

## Why does Bridge to Quads say "only one loop or chain is selected"?

It needs exactly two sides. A single hole is closed with **Fill Holes with Quads**.

## Why does Bridge to Quads say "separate loops or chains are selected: select exactly two"?

More than two separate loops or chains were selected. Select exactly two. The message selects everything you had selected, so deselect the extra ones.

## Why does Bridge to Quads say the selection branches or a loop touches itself?

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.

## Why does Bridge to Quads say "one side is a closed loop and the other an open chain"?

Both sides must be the same kind: two closed loops or two open chains. Select a matching pair.

## Why does Bridge to Quads say the sides have different edge counts, for example 40 and 8 edges?

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.

## Why does Bridge to Quads say "a loop needs at least three edges"?

A closed loop with fewer than three edges cannot form a strip. Check that the selection is the loop you intended.

## Why does Bridge to Quads say the two sides face opposite ways?

The 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.

## Why does Bridge to Quads say a loop "has no length"?

The 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.

## Why does Bridge to Quads say "the strip folds", "twists" or "no quad layout"?

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 **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.

## Why does the bridge leave one triangle?

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.

## Why does N-gons to Quads say "Nothing to convert (all quads or flat n-gons)"?

Everything 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.

## Why do triangles remain after N-gons to Quads or Clean & Quad?

Two 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.

## Why did Clean & Quad leave some n-gons or triangles alone?

Flat 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.

## Why did Clean & Quad change nothing near my corners?

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 **Dissolve Angle**.

## Why does Union to Quads say "The objects do not intersect: nothing was changed"?

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.

## Why does Union to Quads say "Boolean union produced no faces"?

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 **Select Non-Quads & Holes** on each object to check for open boundary edges, and fill the holes first.

## Why does Union to Quads report "left as plain boolean"?

Some 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.

## Why is the Union to Quads seam a zig-zag?

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.

## Where did the other objects go after Union to Quads?

They are hidden. Use **Object > Show/Hide > Reveal Hidden**. With **Keep Originals Hidden** off they are deleted, so `Ctrl+Z` is the way back.

## How do I undo a QuadFix step?

Every 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.

## Related

- Product page: [QuadFix](https://mendboxstudio.com/addons/quadfix)
- [Workflows](https://mendboxstudio.com/docs/quadfix/workflows)
- Guides: [fill a hole with quads](https://mendboxstudio.com/guides/fill-hole-with-quads), [convert n-gons to quads](https://mendboxstudio.com/guides/ngons-to-quads) and [clean up an imported STL](https://mendboxstudio.com/guides/clean-up-imported-stl)

---
Source: https://mendboxstudio.com/docs/quadfix/troubleshooting
