Skip to main content

Menu

Home
Frameworks
GitHub(opens in a new tab)

Getting Started

Overview
Installation
Quick Start
Devtools
Videos & Talks
Comparison
TypeScript
GraphQL
React Native

Guides & Concepts

Important Defaults
Queries
Query Keys
Query Functions
Parallel Queries
Dependent Queries
Background Fetching Indicators
Window Focus Refetching
Disabling/Pausing Queries
Query Retries
Paginated Queries
Infinite Queries
Initial Query Data
Placeholder Query Data
Prefetching
Mutations
Query Invalidation
Invalidation from Mutations
Updates from Mutation Responses
Optimistic Updates
Query Cancellation
Scroll Restoration
Filters
SSR & Next.js
Caching
Default Query Fn
Suspense
Testing
Does this replace [Redux, MobX, etc]?
Migrating to React Query 3

Community Resources

TkDodo's Blog

Examples

Simple
Basic
Basic w/ GraphQL-Request
Auto Refetching / Polling / Realtime
Optimistic Updates in TypeScript
Pagination
Load-More & Infinite Scroll
Suspense
Default Query Function
Playground
Prefetching
Star Wars
Rick And Morty
Next.js
React Native
React Router
Offline Queries and Mutations

Plugins

persistQueryClient (Experimental)
createWebStoragePersistor (Experimental)
createAsyncStoragePersistor (Experimental)
broadcastQueryClient (Experimental)

API Reference

useQuery
useQueries
useInfiniteQuery
useMutation
useIsFetching
useIsMutating
QueryClient
QueryClientProvider
useQueryClient
QueryCache
MutationCache
QueryObserver
InfiniteQueryObserver
QueriesObserver
QueryErrorResetBoundary
useQueryErrorResetBoundary
focusManager
onlineManager
setLogger
hydration

Basic w/ GraphQL-Request

Open in CodeSandbox
View Source

Adapted from tanstack.com/query/v3/docs/framework/react/examples/basic-graphql-request by Tanner Linsley, licensed under MIT. Changes were made: this page is re-rendered from the original's source.

PreviousBasic NextAuto Refetching / Polling / Realtime

Translation © 2026 fanyi.dev · Original © 2026 Tanner Linsley (MIT)

Wide content