npm / @radix-ui/react-avatar
@radix-ui/react-avatar
What changed in @radix-ui/react-avatar 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.
1 breaking1 security1 deprecations1 performance6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@radix-ui/react-avatar 110 changes
Breaking changes 1
A zero-sized image now triggers an error status on load instead of remaining in loading status.
Security 1
Packages now include provenance attestations, allowing developers to verify their origin.
Deprecations 1
Development now warns when multiple Avatar.Image components are rendered per Avatar.Root.
Performance 1
Unused components can now be dropped by bundlers, improving dead-code elimination.
Fixes and other changes 6
Fixed a type regression so callback props accept handlers whose parameter is narrower than the prop's.
All optional types now allow explicit undefined for compatibility with TypeScript's exactOptionalPropertyTypes flag.
Reverted breaking changes that caused compatibility issues with React Server Components.
Conditional exports allow dev-only checks to drop dev-warnings from production builds.
The fallback is displayed again if the image component unmounts.
Console warnings now show in test environments.