If you have tried reading the docs over and over again but you still don't understand useRef, this post is for you!

What is useRef?

useRef is like a box where you can store something for later use. A number, an object, anything you want.


The thing you save in this box is preserved between renders, similar to useState. In other words, the box is not destroyed when your component is updated.

And when you change the box content, nothing happens to the component. The box content changes, but the component remains the same.


  • Unlike component state variables (useState), updating a ref value doesn't trigger a new render.
  • Are you coming from class components? Ok, it is like storing something in an instance variable (this.value = someValue).

What is it used for?

Ok, cool. useRef is used to store something in the component "memory" but it doesn't trigger a new render when the value is updated.

But what is it used for?

Well, there are two main use cases:

1) To store DOM elements so you can later do something with it.

For example, you can focus the password input when the user press "ENTER" on the email input:

Focus the next element when pressing "ENTER"

You can do it with useRef (source code):

export default function App() {
  const emailRef = useRef();
  const passwordRef = useRef();
  return (
    <div className="App">
        <label htmlFor="email">Email:</label>
          onKeyPress={({ charCode }) => {
            if (charCode === 13) {
        <label htmlFor="password">Password:</label>
        <input id="password" ref={passwordRef} />
useRef example to store reference to an input component

2) To store values you want to keep an eye on

Sometimes you want to keep an eye on a value but you don't need to trigger new renders when it changes.

Example: storing the previous value of a state variable.

This is a simple application that display a counter and its previous values. It also has two buttons to increase the counter (by 1 and by 10):

Example of useRef to store a previous value

Source code:

function Counter() {
  const [count, setCount] = useState(0);
  const prevCountRef = useRef();

  useEffect(() => {
    prevCountRef.current = count;

  const prevCount = prevCountRef.current;

  return (
    <div className="App">
      <h1>Previous value with useRef</h1>
        <button onClick={() => setCount((value) => value + 1)}>
          Increase counter by 1
        <button onClick={() => setCount((value) => value + 10)}>
          Increase counter by 10
        Now: {count}, before: {prevCount}

useRef to store a previous value

Hey, I wrote a 10-page e-book about you can download for FREE 🎁 to overcome analysis paralysis when building React applications. It is about:

  1. Code styling and quality.
  2. Organizing your project files.
  3. How to manage your state.

You can grab it below: