Skip to content

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:

  1. Start rendering a low-priority update
  2. Pause when an urgent update arrives (user input)
  3. Resume the low-priority work later
  4. 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

jsx
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

Decode error messages

Plain-English explanations of common errors — what they mean, why they happen, and how to fix them.

View errors

← Back to glossary