Warning: useLayoutEffect does nothing on the server
A component using useLayoutEffect was server-rendered, where layout effects can’t run.
useLayoutEffect does nothing on the server Meaning
Common in libraries during SSR (Next.js, Remix). Usually harmless; React 18.3+ removed this warning.
Common causes
- Library component using useLayoutEffect rendered on the server
- Your own SSR components measuring layout
⚡ Quick fix
- Use an isomorphic layout effect (useEffect on the server)
- Render the component client-only
- Upgrade React/library
Detailed fix by platform
React
const useIsoLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
How to diagnose
- Component — Which one?
- Need — Must it measure layout?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
- [Vue warn]: Hydration node/text/children mismatch Vue: [Vue warn]: Hydration text content mismatch / Hydration node mismatch: server rendered element contains more child nodes than client vdom
- async useEffect Warning: useEffect must not return anything besides a function, which is used for clean-up. It looks like you wrote useEffect(async () => ...)
- Hydration failed Error: Hydration failed because the initial UI does not match what was rendered on the server
Most viewed in React
- React must be in scope ReferenceError: React is not defined / 'React' must be in scope when using JSX
- No QueryClient set Error: No QueryClient set, use QueryClientProvider to set one
- Functions cannot be passed Error: Functions cannot be passed directly to Client Components unless you explicitly expose it by marking it with "use server".
Other ways to find it
Where this error sits
Origin: On your device. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 13 Oct 2026