On this page
Installation
You can install React Query via NPM, or a good ol' <script> via ESM.sh.
NPM
npm i @tanstack/react-query npm i @tanstack/react-query or
pnpm add @tanstack/react-query pnpm add @tanstack/react-query or
yarn add @tanstack/react-query yarn add @tanstack/react-query or
bun add @tanstack/react-query bun add @tanstack/react-query React Query is compatible with React v18+ and works with ReactDOM and React Native.
Wanna give it a spin before you download? Try out the simple or basic examples!
CDN
If you're not using a module bundler or package manager, you can also use this library via an ESM-compatible CDN such as ESM.sh. Simply add a <script type="module"> tag to the bottom of your HTML file:
<script type="module"> import React from 'https://esm.sh/react@18.2.0' import ReactDOM from 'https://esm.sh/react-dom@18.2.0' import { QueryClient } from 'https://esm.sh/@tanstack/react-query' </script> <script type="module"> import React from 'https://esm.sh/react@18.2.0' import ReactDOM from 'https://esm.sh/react-dom@18.2.0' import { QueryClient } from 'https://esm.sh/@tanstack/react-query' </script> You can find instructions on how to use React without JSX here.
Requirements
React Query is optimized for modern browsers. It is compatible with the following browsers config
Chrome >= 91 Firefox >= 90 Edge >= 91 Safari >= 15 iOS >= 15 Opera >= 77 Chrome >= 91 Firefox >= 90 Edge >= 91 Safari >= 15 iOS >= 15 Opera >= 77 Depending on your environment, you might need to add polyfills. If you want to support older browsers, you need to transpile the library from node_modules yourselves.
Recommendations
It is recommended to also use our ESLint Plugin Query to help you catch bugs and inconsistencies while you code. You can install it via:
npm i -D @tanstack/eslint-plugin-query npm i -D @tanstack/eslint-plugin-query or
pnpm add -D @tanstack/eslint-plugin-query pnpm add -D @tanstack/eslint-plugin-query or
yarn add -D @tanstack/eslint-plugin-query yarn add -D @tanstack/eslint-plugin-query or
bun add -D @tanstack/eslint-plugin-query bun add -D @tanstack/eslint-plugin-query 
