Skip to main content


NOTE: Please consider this API as unstable

This hook subscribes a callback to be executed every time there is a change to Recoil atom state. Multiple updates may be batched together in a single transaction. This hook is great for persisting state changes, dev tools, building history, &c.

function useRecoilTransactionObserver_UNSTABLE(({
snapshot: Snapshot,
previousSnapshot: Snapshot,
}) => void)

The callback provides a Snapshot of the current and previous state for the React batch transaction. If you would only like to subscribe to changes for individual atoms, consider effects instead. In the future, we may allow the ability to subscribe to specific conditions or provide debouncing for performance.

Debug Example

function DebugObserver() {
useRecoilTransactionObserver_UNSTABLE(({snapshot}) => {
window.myDebugState = {
a: snapshot.getLoadable(atomA).contents,
b: snapshot.getLoadable(atomB).contents,
return null;

function MyApp() {
return (
<DebugObserver />