TanStackTanStack
Query v5v5
Framework
StartRouter
Data & State
QueryDBStoreAI
UI & UX
TableFormHotkeys
Performance
VirtualPacer
Tooling
DevtoolsConfigCLIIntent
Blog
Blog & Release Notes
About
YouTubeThe official TanStack channel.WorkshopsLive sessions from the maintainers.Release NotesThe latest releases and changelog.
Channels
DiscordReal-time community support.GitHubSource, issues, discussions, and releases.
People & Work
MaintainersMeet the people maintaining the stack.ContributorsCore, library, and community contributors.ShowcaseTeams building with TanStack.
Tools
BuilderAlphaGenerate TanStack app starters.StatsNPM and ecosystem usage data.
Merch
View all
Support
Support OverviewFind the right support path.PartnersCompanies supporting TanStack.OSS SponsorsSponsors keeping TanStack open source.Enterprise SupportPrivate consulting and expert support.ContactGet in touch with the TanStack team.
About
EthosHow we approach open source.TenetsThe values that shape TanStack libraries.Design SystemLogos, tokens, and UI components.
Partners

Sponsorships, placements, and partner pages.

Work with
TanStack
Get in touch
Log In
Log In
Blog & Release Notes
About
YouTubeThe official TanStack channel.WorkshopsLive sessions from the maintainers.Release NotesThe latest releases and changelog.
Channels
DiscordReal-time community support.GitHubSource, issues, discussions, and releases.
People & Work
MaintainersMeet the people maintaining the stack.ContributorsCore, library, and community contributors.ShowcaseTeams building with TanStack.
Tools
BuilderAlphaGenerate TanStack app starters.StatsNPM and ecosystem usage data.
View all
Support
Support OverviewFind the right support path.PartnersCompanies supporting TanStack.OSS SponsorsSponsors keeping TanStack open source.Enterprise SupportPrivate consulting and expert support.ContactGet in touch with the TanStack team.
About
EthosHow we approach open source.TenetsThe values that shape TanStack libraries.Design SystemLogos, tokens, and UI components.
Get in touch
Docs
API Reference
  • QueryClient
  • QueryCache
  • MutationCache
  • QueryObserver
  • InfiniteQueryObserver
  • QueriesObserver
  • streamedQuery
  • focusManager
  • onlineManager
  • environmentManager
  • notifyManager
  • timeoutManager
  • useQuery
  • useQueries
  • useInfiniteQuery
  • useMutation
  • useIsFetching
  • useIsMutating
  • useMutationState
  • useSuspenseQuery
  • useSuspenseInfiniteQuery
  • useSuspenseQueries
  • QueryClientProvider
  • useQueryClient
  • queryOptions
  • infiniteQueryOptions
  • mutationOptions
  • usePrefetchQuery
  • usePrefetchInfiniteQuery
  • QueryErrorResetBoundary
  • useQueryErrorResetBoundary
  • hydration
HomeGet StartedGuidesAPIExamples
API Reference
  • QueryClient
  • QueryCache
  • MutationCache
  • QueryObserver
  • InfiniteQueryObserver
  • QueriesObserver
  • streamedQuery
  • focusManager
  • onlineManager
  • environmentManager
  • notifyManager
  • timeoutManager
  • useQuery
  • useQueries
  • useInfiniteQuery
  • useMutation
  • useIsFetching
  • useIsMutating
  • useMutationState
  • useSuspenseQuery
  • useSuspenseInfiniteQuery
  • useSuspenseQueries
  • QueryClientProvider
  • useQueryClient
  • queryOptions
  • infiniteQueryOptions
  • mutationOptions
  • usePrefetchQuery
  • usePrefetchInfiniteQuery
  • QueryErrorResetBoundary
  • useQueryErrorResetBoundary
  • hydration
AI/LLM: This documentation page is available in plain markdown format at/query/v5/docs/framework/react/reference/useSuspenseQuery.md
API Reference

useSuspenseQuery

tsx
const result = useSuspenseQuery(options)

Options

The same as for useQuery, except for:

  • throwOnError
  • enabled
  • placeholderData

Returns

Same object as useQuery, except that:

  • data is guaranteed to be defined
  • isPlaceholderData is missing
  • status is either success or error
    • the derived flags are set accordingly.

Caveat

Cancellation does not work.

Edit on GitHub
PrevioususeMutationState
NextuseSuspenseInfiniteQuery
Blog
@Tan_Stack on X.com
@TannerLinsley on X.com
GitHub
YouTube
Nozzle.io - Keyword Rank Tracker
Ethos
Tenets
Privacy Policy
Terms of Service
© 2026 TanStack LLC
PartnersBecome a Partner
Gold
CloudflareCloudflare
RailwayRailway
NetlifyNetlify
CodeRabbitCodeRabbit
LovableLovable
Silver
ClerkClerk
SerpApiSerpApi
AG GridAG Grid
OpenRouterOpenRouter
WorkOSWorkOS
Bronze
ElectricElectric
PrismaPrisma
SentrySentry
UnkeyUnkey
Latest Posts