NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #3413 most downloaded on npm
Developer tools to interact with and visualize the TanStack/react-query cache
Latest stable
5.107.1
Last release 15 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
590 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
### Patch Changes - Updated dependencies []: - @tanstack/query-core@5.107.1
#12542 025773a - fix(vue-query): keep query-core's enabled(query) callback. Zero-argument getters and refs stay reactive; the query callback is passed through to query-core.
#12541 f4199ab - feat(vue-query): return a reactive state from useQuery so status === 'success' narrows data without unwrapping refs
Updated dependencies []:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updated dependencies [`a4d72f7`]:
a4d72f7]:
#12494 00dc8de - Reset isRestoring in VueQueryPlugin when the clientPersister promise rejects, so queries no longer wait forever for a failed restore, and handle the rejection instead of leaving it unhandled.
#12537 2cdba60 - fix(vue-query/useInfiniteQuery): return 'UseInfiniteQueryDefinedReturnType' from the 'Defined' overload so 'data' is no longer typed as possibly 'undefined' when 'initialData' is defined
Updated dependencies [b6add89]:
b6add89]:
b6add89]:
a8c2a17 - feat({solid,svelte}-query-devtools): add './production' entry to lazy load the devtools in production buildsa4d72f7]:
a4d72f7 - feat(query-devtools): add a filter scope toggle to filter queries and mutations by key, data (mutation variables or data), or both. Data and All scopes initialize explorer searches with the filter. Mutation explorers initialize searches only for matching variables or data, and filtering refreshes when mutation variables change in place.b6add89]:
a4d72f7]:
### Patch Changes - Updated dependencies []: - @tanstack/query-core@5.106.1
@tanstack/query-persist-client-core@5.106.0
f69b28a - Add search for nested property names and values in the query and mutation Data Explorer, with highlighted matches and automatic expansion.#12499 46d0477 - Let inline devtools panels fill their container height while keeping a 500px default height when the container has no set height.
#12517 1176d37 - chore(query-devtools/tsdown.config): add '@refresh skip' banner so the app's 'solid-refresh' does not wrap the bundled Solid runtime
#12502 254350f - Virtualize query and mutation lists to keep large caches responsive, and reduce repeated cache scans.
Updated dependencies []:
Updated dependencies [`3f4de1b`, `969e580`]:
Updated dependencies [`2ee2fd9`, `8d0dc27`, `e69cac6`, `f2215d2`, `86e7957`, `b6576b3`, `af0e0ef`, `05d9b6a`]:
8d0dc27 - Exclude status from the filters accepted by QueryClient.isMutating, useIsMutating, and injectIsMutating. These APIs always count mutations with status: 'pending'.2ee2fd9, 8d0dc27, e69cac6, f2215d2, 86e7957, b6576b3, af0e0ef, 05d9b6a]:
8d0dc27]:
8d0dc27]:
#12230 1e1caa5 - Update the observer options before subscribing so revealing an <Activity> tree whose query key changed while hidden no longer fetches the previous key.
#12480 8d0dc27 - Exclude status from the filters accepted by QueryClient.isMutating, useIsMutating, and injectIsMutating. These APIs always count mutations with status: 'pending'.
Updated dependencies [2ee2fd9, 8d0dc27, e69cac6, f2215d2, 86e7957, b6576b3, af0e0ef, 05d9b6a]:
#10969 2ee2fd9 - Fix infinite queries to respect a reduced maxPages limit when fetching in either direction.
#12480 8d0dc27 - Exclude status from the filters accepted by QueryClient.isMutating, useIsMutating, and injectIsMutating. These APIs always count mutations with status: 'pending'.
#12442 e69cac6 - Handle the rejection of a paused refetch started by refetchQueries with throwOnError, so cancelling it later no longer causes an unhandled CancelledError.
#12447 f2215d2 - Use () => void instead of the DOM-only VoidFunction type in addConsumeAwareSignal, so the published declarations type-check without the DOM lib.
#10777 86e7957 - Fix shallowEqualObjects to compare own property keys and values and ignore inherited properties. Objects with different own keys now compare as unequal, including when the differing values are undefined.
#12489 b6576b3 - Keep all callers of an in-flight query waiting for the replacement fetch when invalidation cancels it, including after repeated invalidations.
#12481 af0e0ef - Prevent cancelled streamed queries from writing to the cache or starting a delayed stream, even when the stream does not consume the abort signal.
#11788 05d9b6a - Clear isPaused on a mutation that can start once its onMutate resolves, so it is no longer dehydrated and resumed a second time while its request is in flight.
Updated dependencies [`6f8a48d`, `18e54bf`]:
#11373 7ccba6e - fix({react,preact,angular,solid,vue}-query/infiniteQueryOptions): correct the overload selected for a possibly-undefined 'initialData'
#12390 18e54bf - Exclude fetchStatus from the filters accepted by QueryClient.isFetching, useIsFetching, and injectIsFetching. These APIs always count queries with fetchStatus: 'fetching'.
Updated dependencies [6f8a48d, 18e54bf]:
#11678 db79da7 - fix(query-persist-client-core): catch errors when persisting in 'persistQueryClientSubscribe' to prevent unhandled promise rejections, and log them in development
#11919 8be136b - Validate persisted query keys, hashes, state objects, and data update timestamps before retrieval, restoration, garbage collection, or filtered removal. Remove malformed entries without interrupting subsequent queries, while preserving valid null data.
Updated dependencies [6f8a48d, 18e54bf]:
#12406 6f8a48d - Reduce temporary allocations when checking tracked result properties for observer notifications.
#12390 18e54bf - Exclude fetchStatus from the filters accepted by QueryClient.isFetching, useIsFetching, and injectIsFetching. These APIs always count queries with fetchStatus: 'fetching'.
#11373 7ccba6e - fix({react,preact,angular,solid,vue}-query/infiniteQueryOptions): correct the overload selected for a possibly-undefined 'initialData'
#11595 b9f369a - fix(solid-query/{queryOptions,useQuery}): correct the overload selected for 'initialData'
#12390 18e54bf - Exclude fetchStatus from the filters accepted by QueryClient.isFetching, useIsFetching, and injectIsFetching. These APIs always count queries with fetchStatus: 'fetching'.
Updated dependencies [6f8a48d, 18e54bf]:
### Patch Changes - Updated dependencies []: - @tanstack/query-core@5.105.0
8f9dfcb - feat(angular-query-experimental/injectDevtoolsPanel): add the 'theme' and 'hideDisabledQueries' optionsUpdated dependencies [`f608f93`]:
1f8d134]:
f608f93]:
f608f93]:
1f8d134]:
1f8d134]:
1f8d134]:
1f8d134]:
Updated dependencies [`1fee044`, `fce89dd`]:
#11722 0992a92 - fix(react-query-devtools): create the devtools instance only once instead of on every render
#11728 a108398 - fix(react-query*): declare '@types/react' as an optional peer dependency
Updated dependencies [c8f5eac, c208861, b61abc2, a108398]:
#11251 fc3a384 - fix({preact,solid,svelte,angular-query-experimental}): switch to 'export type *' for type-only re-exports
#11375 0addcd2 - Allow queries with falsy errors to retry on mount when throwOnError returns false.
#11259 2ce5190 - fix(preact-query): do not go into optimistic fetching state when not subscribed
Updated dependencies [1fee044, fce89dd]:
#11251 fc3a384 - fix({preact,solid,svelte,angular-query-experimental}): switch to 'export type *' for type-only re-exports
#11920 7ea0278 - fix(solid-query): subscribe to the new observer when the queryClient passed to useQuery changes
Updated dependencies [1fee044, fce89dd]:
Updated dependencies [`0f15bc9`]:
0f15bc9]:
ed4d849 - fix(query-persist-client-core/createPersister): await the storage write in persistQuery, so persistQueryByKey resolves only once the entry has actually been written and rejects when the write fails instead of leaving an unhandled rejection0f15bc9]:
ed4d849]:
ed4d849]:
ed4d849]:
@tanstack/query-persist-client-core@5.104.2
03e8c39]:
Patch Changes Updated dependencies []: @tanstack/query-core@5.104.1
ec060b6]:
ec060b6]:
Updated dependencies [ 5279b05 ]:
5279b05]:
Patch Changes Updated dependencies []: @tanstack/query-core@5.103.3
Updated dependencies [ 8a28904 ]:
8a28904]:
Updated dependencies [ 8330b2f , 3212966 ]:
Updated dependencies [ e57f816 , fdae2ce , a1119e5 , cbf77bf ]:
#11501 9567367 - Declare dependencies used by the published devtools source and type declarations so they resolve with strict package managers. Keep runtime dependencies bundled in the compiled devtools.
Declare the React types used by React Query Devtools as a peer dependency, compatible with React 18 and 19.
Updated dependencies [9567367]:
Patch Changes Updated dependencies []: @tanstack/query-core@5.102.8
Patch Changes Updated dependencies []: @tanstack/query-core@5.102.7
Patch Changes Updated dependencies []: @tanstack/query-core@5.102.6
ac2b612]:
Updated dependencies [ 578e5c2 ]:
578e5c2]:
ef1eff1]:
@tanstack/query-devtools@5.102.4
@tanstack/query-devtools@5.102.3
Updated dependencies [ 80fbf73 ]:
80fbf73]:
Updated dependencies [ 134890d ]:
134890d]:
Updated dependencies [`37127db`, `6e3d521`, `294d4e6`, `cb6c9d3`, `2215bb0`, `1ef4208`, `fb6c3fa`, `8834267`, `b866a95`, `e546d03`, `e674826`]:
### Patch Changes - Updated dependencies \[]: - @tanstack/react-query@5.101.4
@tanstack/query-devtools@5.101.3
7e3c822]:
7e3c822]:
### Patch Changes - Updated dependencies \[]: - @tanstack/query-core@5.101.2
#10813 f5bf180 - fix(query-devtools/PiPContext): reset 'pip_open' in 'localStore' from 'closePipWindow' so the auto-open createEffect does not reopen the window after a programmatic close
#10812 25cdd97 - fix(query-devtools/utils): make 'last updated' sort return 0 for queries with equal 'dataUpdatedAt' to follow the standard comparator contract
#10815 ecd89c8 - fix(query-devtools/utils): scope the 'setupStyleSheet' dedup check to the target so a 'shadowDOMTarget' still receives its own '#_goober' style tag when 'document.head' already has one
#10811 01c7634 - fix(query-devtools/Devtools): correct the Theme sub-trigger className from 'position' to 'theme'
#10736 49012db - setupStyleSheet now sets window.__nonce__ when a styleNonce is provided.
The devtools use goober for CSS-in-JS, which reads window.__nonce__ every time it creates or accesses its style element. Without this, goober overwrote the nonce with undefined, causing CSP violations even when styleNonce was correctly passed to <ReactQueryDevtools>.
Updated dependencies \[`9eff92e`]:
9eff92e]:
9eff92e]:
### Patch Changes - #10826 `1348095` - Replace deprecated isServer with environmentManager.isServer() - Updated dependencies \[]: - @tanstack/query-co
### Patch Changes - Updated dependencies \[]: - @tanstack/query-core@5.100.14
fix(react-query): do not go into optimistic fetching state when not subscribed (#10759)
Updated dependencies []:
ed20b6d]:
ed20b6d]:
ed20b6d]:
fix(query-core): drop the custom NoInfer re-export and rely on TypeScript's built-in NoInfer (TS ≥ 5.4) so NoInfer stays assignable to X[K] in generic
d423168]:
d423168]:
### Patch Changes - Updated dependencies \[]: - @tanstack/query-core@5.100.12
fix(vue-query): allow reactive and getter values as queryKey property in queryOptions
fix(vue-query): allow reactive and getter values as queryKey property in queryOptions (#10530)
This fixes a regression introduced in #10452 where queryOptions only accepted plain arrays for the queryKey property, but not computed refs, Ref values, or getter functions. The related fix in #10465 only covered the enabled property.
Now the queryKey property in queryOptions accepts the same reactive forms as enabled:
QueryKey arraysRef<QueryKey>ComputedRef<QueryKey>() => QueryKey (getter)Updated dependencies []:
Updated dependencies [`4d130b9`]:
4d130b9]:
Updated dependencies \[`fcee7bd`]:
fcee7bd]:
3d21cac]:
3d21cac]:
fcee7bd]:
setOnClose callback type to return void. (#10607)persister's TQueryKey in NoInfer so that the persister slot no longer contributes to TQueryKey inference. Follow-up to #10510, which removed NoInfer on all three persister generics. Preserving NoInfer<TQueryKey> keeps that fix's benefit for TQueryFnData while preventing TQueryKey from widening to the augmented constraint when Register.queryKey is narrowed — which made DataTag-branded wrapper returns un-assignable in contravariant slots. (#10601)3d21cac]:
### Patch Changes - Updated dependencies \[]: - @tanstack/react-query@5.100.8
refactor(preact-query-devtools): replace deprecated 'JSX.CSSProperties' with 'CSSProperties' from Preact namespace (#10622)
Updated dependencies []:
### Patch Changes - Updated dependencies \[]: - @tanstack/query-core@5.100.7
docs(devtools): align logo, panel, and 'buttonPosition' union descriptions across docs and JSDoc (#10617)
Updated dependencies []:
@tanstack/query-devtools@5.100.6
@tanstack/query-devtools@5.100.5
fix(devtools): change onClose callback type from () => unknown to () => void
Updated dependencies [`f85d825`]:
f85d825]:
@tanstack/query-devtools@5.100.2
@tanstack/query-devtools@5.100.1
@tanstack/query-devtools@5.100.0
@tanstack/query-devtools@5.99.2
@tanstack/query-devtools@5.99.1
@tanstack/query-devtools@5.99.0
@tanstack/query-devtools@5.98.0
@tanstack/query-devtools@5.97.0
@tanstack/query-devtools@5.96.2
fix(build): exclude config files from production DTS rollup to prevent @types/node type pollution
fix(build): exclude config files from production DTS rollup to prevent @types/node type pollution (#10358)
Updated dependencies []:
@tanstack/query-devtools@5.96.0
@tanstack/query-devtools@5.95.2
@tanstack/query-devtools@5.95.1
@tanstack/query-devtools@5.95.0
fix(\*): resolve issue about excluded build directory
Updated dependencies [`4c75210`]:
One column per quarter.