# What changed in @tanstack/react-form

> 25 changes in @tanstack/react-form 1 from its official release notes, upgrade guides and advisories: 4 breaking, 4 new APIs and options. Each one cited. Sources checked 2026-11-13. HTML: https://unstale.sh/npm/@tanstack/react-form/

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

## @tanstack/react-form 1

### Breaking changes

- Errors are flattened consistently when form.validate() runs before a field mounts; flattening is enabled by default unless disableErrorFlat is true. (1.28.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.0)
- The Next.js adapter was extracted to this library. (1.25.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.25.0)
- The Remix adapter was extracted to this library. (1.25.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.25.0)
- The Start adapter was extracted to this library and updated to Release Candidate version. (1.25.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.25.0)

### New APIs and options

- Re-exported from the TanStack Store adapters so developers can use it through those adapters. (1.33.1) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.33.1)
- Added the FormGroup API. (1.33.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.33.0)
- Adds an extension method to AppForm so teams can extend upstream AppForms. (1.29.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.29.0)
- Adds useTypedAppFormContext for accessing typed app form context. (1.28.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.0)

### Behavior and default changes

- Form ID generation uses React 18's useId by default, with Math.random() as a fallback if no formId is provided. (1.27.2) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.2)
- The render function can now return any ReactNode, not just JSX.Element. (1.23.8) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.23.8)

### Fixes and other changes

- Uses a fresh FieldApi in the current render when the field name changes. (1.33.2) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.33.2)
- Arrays now re-render when their values change even if their length stays the same. (1.32.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.32.0)
- Fixed field unmount behavior. (1.28.6) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.6)
- The fallback selector for the Subscribe component was reimplemented. (1.28.5) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.5)
- The withForm HOC now returns a named function to enable Fast Refresh. (1.28.5) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.5)
- Form arrays work again. (1.28.3) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.3)
- Fixed various SSR issues so things work as expected in more scenarios. (1.28.1) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.1)
- Fixed a compile error with webpack when using React v17. (1.28.1) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.28.1)
- Array fields with mode="array" now re-render only when the array length changes, not when individual item properties are modified. (1.27.4) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.4)
- FormApi.handleSubmit returns a promise again. (1.27.2) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.2)
- Fixes issues with methods not being present in the React adapter. (1.27.1) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.1)
- Removed useId and replaced it with uuid for React 17 user compatibility. (1.27.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.0)
- Fixed issues with React Compiler. (1.27.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.0)
- Performance was minorly improved and issues with Start were fixed. (1.27.0) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.27.0)
- The props type now allows interfaces to be assigned to it. (1.23.8) — [release notes](https://github.com/TanStack/form/releases/tag/%40tanstack/react-form%401.23.8)