# What changed in @tanstack/react-query > 29 changes in @tanstack/react-query 4 to 5 from its official release notes, upgrade guides and advisories: 6 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-17. HTML: https://unstale.sh/npm/@tanstack/react-query/ To see which of these apply to a repository, run `npx @unstale/cli init` in it. ## @tanstack/react-query 5 ### Breaking changes - The unused experimental_afterQuery hook has been removed. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - The unused experimental_beforeQuery hook has been removed. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - The promise property has been removed from query results. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Experimental render-time prefetching has been removed. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - placeholderData has been removed from suspense infinite queries. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Adds environmentManager. (5.91.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.91.0) ### Behavior and default changes - TData now defaults to InfiniteData to match hook generics. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - usePrefetchInfiniteQuery now uses queryClient.infiniteQuery for prefetching. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - usePrefetchQuery now uses queryClient.query for prefetching. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - TData now defaults to InfiniteData to match hook generics. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) ### Tooling - Codemods no longer copy unnecessary files from the codemods project. (5.103.3) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.103.3) ### Fixes and other changes - useQueries and useSuspenseQueries now throw falsy errors to the error boundary. (5.102.6) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.6) - Return types can be emitted in declaration files without leaking internal data tag symbols. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Return types can be emitted in declaration files without leaking internal data tag symbols. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Type-only exports no longer emit a runtime import. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Mutation variables become optional when undefined extends TVariables. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Generic type parameters now propagate to the useMutationState select callback. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - Unsubscribed useQueries no longer show optimistic fetching. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - useQuery return types retain NoInfer. (5.102.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.102.0) - React Query no longer enters optimistic fetching state when the query is not subscribed. (5.100.14) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.100.14) - Suspense queries now skip calling combine, preventing combine from running when queries would suspend. (5.100.3) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.100.3) - Resolved an issue involving the excluded build directory. (5.94.5) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.94.5) - Maintains error state on reset refetch when initialData is defined. (5.91.2) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.91.2) - Allows retryOnMount when throwOnError is a function. (5.90.16) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.90.16) - Prevents infinite render loops when useSuspenseQueries has duplicate queryKeys. (5.90.11) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%405.90.11) ## @tanstack/react-query 4 ### New APIs and options - Adds mutationOptions to React Query v4 for configuring mutations. (4.44.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%404.44.0) - Adds usePrefetchInfiniteQuery to react-query. (4.43.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%404.43.0) - Adds usePrefetchQuery to react-query. (4.43.0) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%404.43.0) ### Fixes and other changes - Updated to support React 19 as a peer dependency correctly. (4.42.2) — [release notes](https://github.com/TanStack/query/releases/tag/%40tanstack/react-query%404.42.2)