Docs
Cloudflare
CodeRabbit
Railway
Clerk
Netlify
AG Grid
OpenRouter
SerpAPI
WorkOS
Electric
Prisma
Sentry
Unkey
Cloudflare
CodeRabbit
Railway
Clerk
Netlify
AG Grid
OpenRouter
SerpAPI
WorkOS
Electric
Prisma
Sentry
Unkey
API Reference

queryOptions

tsx
queryOptions({
  queryKey,
  ...options,
})
queryOptions({
  queryKey,
  ...options,
})

Options

You can generally pass everything to queryOptions that you can also pass to useQuery. Some options will have no effect when then forwarded to a function like queryClient.prefetchQuery, but TypeScript will still be fine with those excess properties.

  • queryKey: QueryKey
    • Required
    • The query key to generate options for.
  • experimental_prefetchInRender?: boolean
    • Optional
    • Defaults to false
    • When set to true, queries will be prefetched during render, which can be useful for certain optimization scenarios
    • Needs to be turned on for the experimental useQuery().promise functionality

Further reading

To learn more about QueryOptions, have a look at this article by TkDodo The Query Options API.