skip to content

Blender logoblender · HeyBraza shows you

blender bone heat weighting failed

HeyBraza points at the mesh cleanup steps and the ctrl+p menu so automatic weights finally completes.

HeyBraza in a real session - not this exact fix.

'bone heat weighting failed' means blender's weight solver choked on the mesh - doubled vertices, loose geometry, non-manifold faces or an unapplied scale. clean those and the same parenting command works.

or do it yourself

  1. 1select the mesh, go to object mode and press ctrl + a > 'scale' - a non-1 scale alone can break the solver.
  2. 2in edit mode select all (a) and press m > 'merge by distance' to kill duplicate vertices.
  3. 3still in edit mode, use select > 'all by trait' > 'loose geometry' and delete anything it finds (x > vertices).
  4. 4check the bones actually sit inside the mesh - bones outside the surface can't find geometry to weight.
  5. 5back in object mode select the mesh, shift-select the armature, then press ctrl + p > 'with automatic weights'.

let HeyBraza do this with you

HeyBraza is a tiny on-screen guide that points at the right buttons and talks you through it, on windows and mac.

download

common questions

what if it still fails?

parent with 'empty groups' instead, then paint the weights yourself in weight paint mode - slower, but it always works.

why did my model become huge after parenting?

the armature had an unapplied scale. select it, ctrl + a > 'scale', clear the parent, and parent again.

more fixes