--- id: useIsFetching title: useIsFetching redirect_from: - framework/react/reference/useIsFetching --- ```ts function useIsFetching(filters?: QueryFilters, queryClient?: QueryClient): number; ``` Defined in: [packages/react-query/src/useIsFetching.ts:41](https://github.com/TanStack/query/blob/main/packages/react-query/src/useIsFetching.ts#L41) The `useIsFetching` hook returns the `number` of the queries that your application is loading or fetching in the background (useful for app-wide loading indicators). ## Parameters ### filters? [`QueryFilters`](../interfaces/QueryFilters.md)\ The [QueryFilters](../interfaces/QueryFilters.md) to narrow down the matched queries. #### `filters` properties | Property | Type | Default value | Description | | ------ | ------ | ------ | ------ | | `exact?` | `boolean` | `undefined` | Match query key exactly | | `fetchStatus?` | `"fetching"` \| `"paused"` \| `"idle"` | `undefined` | Include queries matching their fetchStatus | | `predicate?` | (`query`: [`Query`](../classes/Query.md)) => `boolean` | `undefined` | Include queries matching this predicate function | | `queryKey?` | `TQueryKey` \| `TuplePrefixes`\<`TQueryKey`\> | `undefined` | Include queries matching this query key | | `stale?` | `boolean` | `undefined` | Include or exclude stale queries | | `type?` | `QueryTypeFilter` | `'all'` | Filter to active queries, inactive queries or all queries | ### queryClient? [`QueryClient`](../classes/QueryClient.md) Use this to use a custom `QueryClient`. Otherwise, the one from the nearest context will be used. ## Returns `number` Will be the `number` of the queries that your application is currently loading or fetching in the background. ## Examples ```tsx import { useIsFetching } from '@tanstack/react-query' function PostsFetchingIndicator() { // How many queries matching the posts prefix are fetching? const isFetchingPosts = useIsFetching({ queryKey: ['posts'] }) return isFetchingPosts ? Refreshing posts... : null } ``` A global loading indicator for any query fetching in the background, not just the ones on screen: ```tsx import { useIsFetching } from '@tanstack/react-query' function GlobalLoadingIndicator() { const isFetching = useIsFetching() return isFetching ? (
Queries are fetching in the background...
) : null } ```