Hook · React 19 · react-dom
useFormStatus
Read the form state from a child
useFormStatus reads the state of the nearest form up the tree: whether it's pending, what data it submitted, and with what method. It lets you create reusable components without prop drilling.
Usage rule
Must be called from a component that is a child of the <form>, not from the same component that renders it. It's the inverse pattern to passing isPending as a prop.
What it exposes
{ pending, data, method, action }. pending is the most-used flag. data is the FormData in-flight — useful for showing a preview of the value while it waits.
Common pitfalls
- 01useFormStatus must be in a component nested inside the form — not in the form component itself.
- 02It only works with native HTML forms or React 19 form actions — not with custom onSubmit handlers alone.
- 03pending is true only while the form action (async function) is running.
Was this helpful?
Sign in to give feedback