Shadow DOM

W3C Working Group Note

This version:
Latest published version:
Previous Version:
Latest editor's draft:
Hayato Ito, Google, Inc.
Revision history:
Bugs filed:
Can I use Shadow DOM?
Test Suite
Test Suite repository


This specification describes a method of combining multiple DOM trees into one hierarchy and how these trees interact with each other within a document, thus enabling better composition of the DOM.

Status of This Document

This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at

Shadow DOM specification is being incorporated into to the DOM specification, HTML specification, CSS Scoping Module Level 1, UI Events specification, and other relevant specifications.

Please consult the W3C Web Components repository for continuing discussion on this subject.

This document was published by the Web Platform Working Group as a Working Group Note. Comments regarding this document are welcome. Please send them to (subscribe, archives).

Publication as a Working Group Note does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

This document was produced by a group operating under the W3C Patent Policy.

This document is governed by the 1 February 2018 W3C Process Document.