How to replace a DOM element
New Courses Coming Soon
Join the waiting lists
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)
→ 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:
- COURSES where I teach everything I know
- CODING BOOTCAMP cohort course - next edition in 2025
- BOOKS 16 coding ebooks you can download for free on JS Python C PHP and lots more
- Follow me on X