[ Web Proxy ]
URL:
Viewing: https://tanstack.com/query/latest [Back]  [Original]
TanStack Query
TanStack [TanStack] []
Libraries
Framework
StartRouter
Data & State
QueryDBStoreAI
UI & UX
TableChartsFormHotkeysMarkdownHighlight
Performance
VirtualPacer
Tooling
DevtoolsConfigCLIIntent
Browse all libraries
Blog
Blog & Release Notes
About
YouTubeThe official TanStack channel.WorkshopsLive sessions from the maintainers.Release NotesThe latest releases and changelog.
Community
Tools
Merch
View all
Support
Partners

Sponsorships, placements, and partner pages.

Work with
TanStack [TanStack] []
Partnership Inquiry
QueryMenuMenu

The server-state standard for modern frontend apps.

Query gives async data a cache, a lifecycle, and declarative APIs for fetching, sharing, refetching, mutating, and observing server state.

DocsCopy Query prompt
query client
stale0/3 fresh
['issues', 'router-cache']Router dashboardfetchingP04s stale['issues', 'project-detail']Project detailfetchingP08s stale['issues', 'offline-queue']Offline mutation queuefetchingP012s stale
Live off
Bump priority

useQuery()

['issues', 'router-cache']

Components declare the data they need. The cache coordinates fetches, subscribers, freshness, retries, and background updates.

status
success
fetchStatus
fetching
isStale
true
observers
0
staleTime
4,000
updated
primed
mutation
idle
2.4Btotal downloads71,255,630weekly downloads50,165GitHub stars

Server and client state are not the same

Deadly defaultsQuery keysState ManagementDevtools

Deadly defaults kill boring work.

Caching, request deduplication, retries, background refetching, window-focus updates, and garbage collection arrive wired for real applications.

Cache lifecycle

Keep data useful while the network catches up.

Stale data can remain valuable. Render from cache immediately, refresh quietly, and clean up only after the last observer leaves.

1

Fetch

A query function resolves data while Query owns cancellation, retries, and deduplication.

2

Share

Every observer reads the same cache entry instead of issuing another request.

3

Revalidate

Stale data stays visible while a background request refreshes it.

4

Collect

Unused data remains available briefly, then garbage collection removes it.

Mutations

Writes update the world, then the cache.

Optimistic UI, pending state, recovery, invalidation, and reconciliation stay explicit instead of scattering through components.

optimistic write

setQueryData(['todos'], next)

server mutation

await saveTodo(todo)

targeted refresh

invalidateQueries({ queryKey: ['todos'] })

rollback path

onError: restoreSnapshot

The open source application stack for the web.

Libraries

Blog

Community

Tools

Merch

Support

2026 TanStack LLC

Web Proxy Viewer  |  New URL  |  Original Page