<content>: The Shadow DOM Content Placeholder element

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The <content> HTML element—an obsolete part of the Web Components suite of technologies—was used inside of Shadow DOM as an insertion point, and wasn't meant to be used in ordinary HTML. It has now been replaced by the <slot> element, which creates a point in the DOM at which a shadow DOM can be inserted.

Note: Though present in early draft of the specifications and implemented in several browsers, this element has been removed in later versions of the spec, and should not be used. It is documented here to assist in adapting code written during the time it was included in the spec to work with newer versions of the specification.

Content categories Transparent content.
Permitted content Flow content.
Tag omission None, both the starting and ending tag are mandatory.
Permitted parent elements Any element that accepts flow content.
DOM interface HTMLContentElement


This element includes the global attributes.


A comma-separated list of selectors. These have the same syntax as CSS selectors. They select the content to insert in place of the <content> element.


Here is a simple example of using the <content> element. It is an HTML file with everything needed in it.

Note: For this code to work, the browser you display it in must support Web Components. See Enabling Web Components in Firefox.

<html lang="en">
    <!-- The original content accessed by <content> -->
      <h4>My Content Heading</h4>
      <p>My content text</p>

      // Get the <div> above.
      const myContent = document.querySelector("div");

      // Create a shadow DOM on the <div>
      const shadowroot = myContent.createShadowRoot();

      // Insert into the shadow DOM a new heading and
      // part of the original content: the <p> tag.
      shadowroot.innerHTML =
        '<h2>Inserted Heading</h2> <content select="p"></content>';

If you display this in a web browser it should look like the following.

content example


This element is no longer defined by any specifications.

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet

See also

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.