`<slot>` HTML web component slot element

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

See full compatibility

The <slot> HTML element—part of the Web Components technology suite—is a placeholder inside a web component that you can fill with your own markup, which lets you create separate DOM trees and present them together.

Attributes

This element includes the global attributes.

name: The slot's name. When the slot's containing component gets rendered, the slot is rendered with the custom element's child that has a matching slot attribute. A named slot is a <slot> element with a name attribute. Unnamed slots have the name default to the empty string. Names should be unique per shadow root: if you have two slots with the same name, all of the elements with a matching slot attribute will be assigned to the first slot with that name.

Examples

html

<template id="element-details-template">
  <style>
    details {
      font-family: "Open Sans Light", "Helvetica", "Arial", sans-serif;
    }
    .name {
      font-weight: bold;
      color: #217ac0;
      font-size: 120%;
    }
    h4 {
      margin: 10px 0 -8px 0;
      background: #217ac0;
      color: white;
      padding: 2px 6px;
      border: 1px solid #cee9f9;
      border-radius: 4px;
    }
    .attributes {
      margin-left: 22px;
      font-size: 90%;
    }
    .attributes p {
      margin-left: 16px;
      font-style: italic;
    }
  </style>
  <details>
    <summary>
      <code class="name">
        &lt;<slot name="element-name">NEED NAME</slot>&gt;
      </code>
      <span class="desc"><slot name="description">NEED DESCRIPTION</slot></span>
    </summary>
    <div class="attributes">
      <h4>Attributes</h4>
      <slot name="attributes"><p>None</p></slot>
    </div>
  </details>
  <hr />
</template>

Note: You can see this complete example in action at element-details (see it running live). In addition, you can find an explanation at Using templates and slots.

Technical summary

Content categories	Flow content, phrasing content
Permitted content	Transparent
Events	`slotchange`
Tag omission	None, both the starting and ending tag are mandatory.
Permitted parents	Any element that accepts phrasing content
Implicit ARIA role	No corresponding role
Permitted ARIA roles	No `role` permitted
DOM interface	`HTMLSlotElement`

Specifications

Specification
HTML # the-slot-element
DOM # shadow-tree-slots

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`slot`	Chrome – Full support Chrome 53 (Release date: 2016-08-31) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 63 (Release date: 2018-10-23) footnote Full support	Opera – Full support Opera 40 (Release date: 2016-09-20) footnote Full support	Safari – Full support Safari 10 (Release date: 2016-09-20) footnote Full support	Chrome Android – Full support Chrome Android 53 (Release date: 2016-09-07) footnote Full support	Firefox for Android – Full support Firefox for Android 63 (Release date: 2018-10-23) footnote Full support	Opera Android – Full support Opera Android 41 (Release date: 2016-10-25) footnote Full support	Safari on iOS – Full support Safari on iOS 10 (Release date: 2016-09-13) footnote Full support	Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 53 (Release date: 2016-09-07) footnote Full support	WebView on iOS – Full support WebView on iOS 10 (Release date: 2016-09-13) footnote Full support
`name`	Chrome – Full support Chrome 53 (Release date: 2016-08-31) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 63 (Release date: 2018-10-23) footnote Full support	Opera – Full support Opera 40 (Release date: 2016-09-20) footnote Full support	Safari – Full support Safari 10 (Release date: 2016-09-20) footnote Full support	Chrome Android – Full support Chrome Android 53 (Release date: 2016-09-07) footnote Full support	Firefox for Android – Full support Firefox for Android 63 (Release date: 2018-10-23) footnote Full support	Opera Android – Full support Opera Android 41 (Release date: 2016-10-25) footnote Full support	Safari on iOS – Full support Safari on iOS 10 (Release date: 2016-09-13) footnote Full support	Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 53 (Release date: 2016-09-07) footnote Full support	WebView on iOS – Full support WebView on iOS 10 (Release date: 2016-09-13) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support

<slot> HTML web component slot element