Skip to content

How to replace a DOM element

New Course Coming Soon:

Get Really Good at Git

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)
Are you intimidated by Git? Can’t figure out merge vs rebase? Are you afraid of screwing up something any time you have to do something in Git? Do you rely on ChatGPT or random people’s answer on StackOverflow to fix your problems? Your coworkers are tired of explaining Git to you all the time? Git is something we all need to use, but few of us really master it. I created this course to improve your Git (and GitHub) knowledge at a radical level. A course that helps you feel less frustrated with Git. Launching May 21, 2024. Join the waiting list!
→ Read my DOM Tutorial on The Valley of Code
→ Read my Browser Events Tutorial on The Valley of Code
→ Read my Browser APIs Tutorials on The Valley of Code

Here is how can I help you: