Get to know MDN better
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The HTMLSlotElement interface of the Shadow DOM API enables access to the name and assigned nodes of an HTML <slot> element.
EventTarget Node Element HTMLElement HTMLSlotElementAlso inherits properties from its parent interface, HTMLElement.
HTMLSlotElement.nameA string used to get and set the slot's name.
Also inherits methods from its parent interface, HTMLElement.
HTMLSlotElement.assign()Sets the manually assigned nodes for this slot to the given nodes.
HTMLSlotElement.assignedNodes()Returns a sequence of the nodes assigned to this slot. If the flatten option is set to true, it returns a sequence of both the nodes assigned to this slot, and the nodes assigned to any other slots that are descendants of this slot. If no assigned nodes are found, it returns the slot's fallback content.
HTMLSlotElement.assignedElements()Returns a sequence of the elements assigned to this slot (and no other nodes). If the flatten option is set to true, it returns a sequence of both the elements assigned to this slot, and the elements assigned to any other slots that are descendants of this slot. If no assigned elements are found, it returns the slot's fallback content.
Also inherits events from its parent interface, HTMLElement.
Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface.
slotchangeFired on an HTMLSlotElement instance (<slot> element) when the node(s) contained in that slot change.
The following snippet is taken from our slotchange example (see it live also).
Here we grab references to all the slots, then add a slotchange event listener to the 2nd slot in the template — which is the one that keeps having its contents changed in the example.
Every time the element inserted in the slot changes, we log a report to the console saying which slot has changed, and what the new node inside the slot is.
| HTML # htmlslotelement |
Enable JavaScript to view this browser compatibility table.
This page was last modified on Sep 25, 2025 by MDN contributors.
Your blueprint for a better internet.
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.