# What changed in @radix-ui/react-avatar

> 10 changes in @radix-ui/react-avatar 1 from its official release notes, upgrade guides and advisories: 1 breaking, 1 deprecations, 1 security. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@radix-ui/react-avatar/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @radix-ui/react-avatar 1

### Breaking changes

- A zero-sized image now triggers an error status on load instead of remaining in loading status. (1.2.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#120)

### Security

- Packages now include provenance attestations, allowing developers to verify their origin. (1.2.4) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#124)

### Deprecations

- Development now warns when multiple Avatar.Image components are rendered per Avatar.Root. (1.2.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#120)

### Performance

- Unused components can now be dropped by bundlers, improving dead-code elimination. (1.2.3) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#123)

### Fixes and other changes

- Fixed a type regression so callback props accept handlers whose parameter is narrower than the prop's. (1.3.1) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#131)
- All optional types now allow explicit undefined for compatibility with TypeScript's exactOptionalPropertyTypes flag. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#130)
- Reverted breaking changes that caused compatibility issues with React Server Components. (1.2.6) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#126)
- Conditional exports allow dev-only checks to drop dev-warnings from production builds. (1.2.3) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#123)
- The fallback is displayed again if the image component unmounts. (1.2.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#120)
- Console warnings now show in test environments. (1.2.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/avatar/CHANGELOG.md#120)