Hi everyone,

We’re excited to share that HeroUI Beta 3 is now live.

This release continues to refine the v3 foundation with new components, better layout control, cleaner visuals, and important breaking changes as we move closer to a stable release.

New components

This update introduces 7 new components that expand HeroUI’s form, input, and composition capabilities:

ButtonGroup → https://v3.heroui.com/docs/components/button-group

DateField → https://v3.heroui.com/docs/components/date-field

TimeField → https://v3.heroui.com/docs/components/time-field

ScrollShadow → https://v3.heroui.com/docs/components/scroll-shadow

SearchField → https://v3.heroui.com/docs/components/search-field

TagGroup → https://v3.heroui.com/docs/components/tag-group

ErrorMessage → https://v3.heroui.com/docs/components/error-message

Component and API improvements

This release focuses heavily on layout clarity and visual polish:

• New fullWidth prop on multiple components for better form and layout composition

• New hideSeparator prop for Tabs, Accordion, and group components

• Smoother animations and refined motion behavior

• Style fixes across multiple components

• Docs icons upgrade for better visual consistency

⚠️ Breaking changes

As part of simplifying the API and improving long term maintainability:

• The asChild prop has been removed

• AlertDialog and Modal backdrop variants have been updated

Please review the changelog before upgrading if you rely on these APIs. →

https://v3.heroui.com/docs/changelog/v3-0-0-beta-3

Upgrade with your AI assistant

If you use AI tools like Cursor or Claude Code, upgrading is straightforward.

Just prompt:

“Update HeroUI to the latest version”

Your assistant will compare versions, apply required changes, update imports, and refactor your code where needed.

Learn more about the HeroUI MCP server here →

https://v3.heroui.com/docs/ui-for-agents/mcp-server

Full changelog

Read the complete list of updates here →

https://v3.heroui.com/docs/changelog/v3-0-0-beta-3

Thank you for being part of the HeroUI community.

Each beta brings us closer to HeroUI v3 stable, and we’re excited to keep sharing progress with you.

Talk soon,

The HeroUI Team