Skip to content

Bug: useContext not updating when Provider value changes

Error message

                Context consumer not re-rendering when the Provider value changes
              

Quick summary

The Context Provider's value prop didn't get a new reference, so consumers didn't detect the change and didn't re-render.

Why this happens

  • Provider value is an object created in render but not memoized

  • Value object has the same content but a new reference every render (causes over-rendering, not under-rendering)

  • Value is a primitive that didn't actually change

  • Consumer is outside the Provider tree

Minimal example

✗ Broken code
// Value never changes reference
const value = { user: null };
return <UserContext.Provider value={value}>...</UserContext.Provider>;
// Even if you set value.user later, consumers won't update
✓ Fixed code
const [user, setUser] = useState(null);
return <UserContext.Provider value={{ user }}>...</UserContext.Provider>;
// New object created when user changes, consumers re-render

Creating a new object { user } when user changes gives the Provider a new value reference, triggering consumer re-renders.

How to diagnose

  • Check if the Provider value is an object/array and whether it changes reference

  • Verify the consumer is a descendant of the Provider

  • Log the context value in the consumer to see if it updates

How to fix

  • Ensure the Provider value actually changes when expected

  • If using an object value, make sure a new object is created when content changes

  • Use useMemo for the Provider value to control when it changes

How to prevent

  • Understand that Context uses reference equality to detect changes

  • Use useMemo for object/array Provider values

Related Resources

Related Glossary

Related Lessons

← Back to language