v3.2.6

heroui-inc/herouiv3.2.6Sep 17, 2026by github-actions[bot]

Upgrading?

AI Summary

This release focuses on performance optimization with reduced unnecessary re-renders across 43 components, introduces new grid and stacked layouts for the AvatarGroup component, and restores keyboard-only focus rings for interactive elements. It also includes updates to React Aria and fixes for spacing issues in Tag and Breadcrumb components. Note that peer dependency requirements have been updated.

Key Highlights

  • Performance optimizations reducing unnecessary re-renders across 43 components.
  • AvatarGroup now supports stacked, grid layouts, overflow counts, and shared styling.
  • Focus rings restored to keyboard-only behavior for menus, selects, and overlay triggers.
  • React Aria upgraded to version 1.21.1.
  • Calendar year picker labels now stay in sync with locale and time zone.

Breaking Changes

  • @internationalized/date@^3.12.4 is now a peer dependency.
  • React Aria requirements have changed; check the release notes before updating.

New Features

  • AvatarGroup now supports stacked, grid layouts, overflow counts, and shared styling.

Full Release Notes

## What's inside

- AvatarGroup → stacked or grid layouts, overflow counts & shared styling
- Performance → fewer unnecessary re-renders across 43 components
- Focus rings → keyboard-only again on menus, selects & overlay triggers
- Tag / Breadcrumbs → default padding & spacing fixes
- Calendar → year picker labels stay in sync with locale & time zone
- ColorSlider → no validation warnings in production
- React Aria → upgraded to 1.21.1

## What's Changed
* build(deps): bump next from 16.3.0 to 16.3.3 by @dependabot[bot] in https://github.com/heroui-inc/heroui/pull/6843
* fix(docs): stop sidebar scrollbar lagging behind the scroll offset by @wingkwong in https://github.com/heroui-inc/heroui/pull/6858
* docs(blog): mention Morph dedicated capacity in design system article by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6860
* docs(web): add dedicated autocomplete custom value demo by @wingkwong in https://github.com/heroui-inc/heroui/pull/6864
* feat(docs): add project-scoped HeroUI Pro skill install by @wingkwong in https://github.com/heroui-inc/heroui/pull/6867
* docs: add React Router to frameworks page and use init template flag by @wingkwong in https://github.com/heroui-inc/heroui/pull/6868
* fix(docs): resolve invisible showcase status chip in light mode by @wingkwong in https://github.com/heroui-inc/heroui/pull/6869
* docs: add non-react framework usage to frameworks page by @wingkwong in https://github.com/heroui-inc/heroui/pull/6870
* docs: fix broken component classes link on styling page by @wingkwong in https://github.com/heroui-inc/heroui/pull/6871
* V3.2.6 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6850

## Upgrade Notes
- Update with `npm i @heroui/styles@latest @heroui/react@latest`.
- `@internationalized/date@^3.12.4` is now a peer dependency. React Aria requirements also changed; check the release notes before updating.

## Full Release Notes

https://heroui.com/en/docs/react/releases/v3-2-6

**Full Changelog**: https://github.com/heroui-inc/heroui/compare/v3.2.5...v3.2.6

Related Repositories