Concurrent Mode
In one line
Concurrent Mode enables React to interrupt rendering for urgent updates — enabled by default with createRoot.
In simple words
Concurrent Mode is React 18's rendering paradigm. Unlike the old synchronous rendering (which blocked the main thread until done), concurrent rendering can:
- Start rendering a low-priority update
- Pause when an urgent update arrives (user input)
- Resume the low-priority work later
- Discard stale work if newer data arrived
In React 18, concurrent mode is enabled by default when you use createRoot (instead of the old ReactDOM.render). You don't need to opt-in — it's the default.
Key features that require concurrent mode: useTransition, useDeferredValue, Suspense for data fetching, automatic batching, selective hydration.
Example
import { createRoot } from "react-dom/client";
import App from "./App";
// React 18 — enables concurrent mode by default
const root = createRoot(document.getElementById("root"));
root.render(<App />);
// Old React 17 — synchronous rendering
// import { render } from "react-dom";
// render(<App />, document.getElementById("root"));
// With concurrent mode, this transition can be interrupted:
function TabSwitch() {
const [isPending, startTransition] = useTransition();
const [tab, setTab] = useState("home");
return (
<button onClick={() => startTransition(() => setTab("settings"))}>
{isPending ? "Switching..." : "Go to Settings"}
</button>
);
}createRoot enables concurrent mode. Transitions can be interrupted by user input, keeping the app responsive during expensive updates.
Common confusions
Confused with: concurrent features
The difference: Concurrent Mode is the rendering paradigm (the engine). Concurrent Features are the specific APIs built on top of it (useTransition, Suspense, etc.). Mode is the foundation; features are the tools you use.
Related terms
Related Resources
Related Lessons
- React 18 Features
Concurrent mode.
Decode error messages
Plain-English explanations of common errors — what they mean, why they happen, and how to fix them.