Skip to content

How to replace a DOM element

Given a DOM element, how do you replace it with another?

Say you have a DOM element, which you have a reference to (maybe retrieved using querySelector()).

To replace it with another DOM element, you can call the replaceWith() method on the first element, passing the second element as argument:

const el1 = document.querySelector(/* ... */)
const el2 = document.querySelector(/* ... */)

el1.replaceWith(el2)

Since Edge <17 and IE11 do not support it, you should transpile it to ES5 using Babel if you plan to support those browsers.

Another solution is to lookup the parent and use the replaceChild() method, which is much older and supported by all browsers:

const el1 = document.querySelector(/* ... */)
const el2 = document.querySelector(/* ... */)

el1.parentNode.replaceChild(el2, el1)

→ Here's my latest YouTube video

→ I wrote 17 books to help you become a better developer, download them all at $0 cost by joining my newsletter

JOIN MY CODING BOOTCAMP, an amazing cohort course that will be a huge step up in your coding career - covering React, Next.js - next edition February 2025

Bootcamp 2025

Join the waiting list