Framework
Version
Menu
Getting Started
Guides & Concepts
Community Resources
API Reference
ESLint
Plugins
Examples

Installation

You can install React Query via NPM, or a good ol' <script> via unpkg.com.

NPM

bash
npm i @tanstack/react-query@4

or

bash
pnpm add @tanstack/react-query@4

or

bash
yarn add @tanstack/react-query@4

React Query is compatible with React v16.8+ 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 we also have a global ("UMD") build hosted on the unpkg.com CDN. Simply add the following <script> tag to the bottom of your HTML file:

html
<script src="https://unpkg.com/@tanstack/react-query@4/build/umd/index.production.js"></script>

Once you've added this you will have access to the window.ReactQuery object and its exports.

This installation/usage requires the React CDN script bundles to be on the page as well.

Requirements

React Query is optimized for modern browsers. It is compatible with the following browsers config

bash
Chrome >= 73
Firefox >= 78
Edge >= 79
Safari >= 12.1
iOS >= 12.2
Opera >= 53

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:

bash
npm i -D @tanstack/eslint-plugin-query@4

or

bash
pnpm add -D @tanstack/eslint-plugin-query@4

or

bash
yarn add -D @tanstack/eslint-plugin-query@4
Want to Skip the Docs?
Query.gg - The Official React Query Course
“This course is the best way to learn how to use React Query in real-world applications.”—Tanner Linsley
Check it out
scarf analytics