Redux Toolkit · Function

batch

batch groups multiple React updates into one render pass, commonly wrapping several dispatches made outside React. React 18 automatically batches updates, so explicit use is usually unnecessary there.

How it works

Call batch with a callback containing multiple dispatches when those dispatches occur outside React and should produce one combined render update. The function delegates batching to the underlying React renderer; with React 18, automatic batching generally makes explicit use unnecessary.

Syntax

batch((fn: () => void))

Parameters

Name	Type	Description
`fn`	`() => void`	Callback containing the React updates or dispatches to batch.

Returns

The page documents the callback signature but does not specify a separate return value.

Key points

React-Redux exposes the batching helper under the stable public name batch.
Wrapping outside-React dispatches can reduce their result to one React render update.
The implementation supports both ReactDOM and React Native environments.

Common mistakes

React 18 automatically batches state updates, so explicit batch calls are generally unnecessary.
Automatic batching in React 18 covers updates regardless of where they are queued.

Example: Batch multiple dispatches

import { batch } from 'react-redux'
import { increment } from './counterSlice'

export function incrementTwice() {
  return (dispatch) => {
    batch(() => {
      dispatch(increment())
      dispatch(increment())
    })
  }
}

Groups the two dispatches so React performs one combined render update when batching is needed.

When to use it

Group thunk dispatches

A thunk dispatches several actions and the resulting React updates should be rendered together.

Batch external updates

A non-React callback performs multiple store updates in one event-loop turn.

Coordinate renderer batching

A shared application supports React versions or environments where explicit renderer batching is still needed.

Interview questions

QWhat is the signature and purpose of batch?

batch accepts a callback: batch((fn: () => void)). Dispatches placed inside that callback can be combined into one React render update when they occur outside React.

Follow-up: Does it combine Redux subscriber notifications? No. It targets React rendering; Redux dispatches and selector work can still occur for each action.

QWhen would you use batch?

Use it around multiple dispatches in a thunk or another non-React execution path when avoiding multiple React renders matters. The callback is executed as the batching unit.

Follow-up: How does React 18 change this recommendation? React 18 automatically batches all state updates, so explicit use is usually unnecessary.

QWhere does batch come from and how is renderer compatibility handled?

The public function is exported from react-redux, and React-Redux chooses the correct renderer-specific batching implementation for ReactDOM and React Native. It is therefore used through the React-Redux package rather than imported directly from a renderer.

Follow-up: What should be checked before adding it to new code? Verify the application is not already relying on React 18 automatic batching.

unstable_batchedUpdates
React 18 automatic batching
ReactDOM
React Native

Source: batch(). Checked 2026-10-15.