Web platform features explorer - Scoped custom element registries

The CustomElementRegistry() constructor creates a new custom element registry that's separate from the global window.customElements registry. Creating more than one registry is useful for multiple custom elements that have the same tag name to coexist.

Status

Limited availability

MDN documentation

No MDN documentation found. You can search for the feature on MDN. If you believe that MDN has no documentation about this feature, you can open an issue on MDN's GitHub repository.

Specifications

HTML (#custom-elements-api), from HTML Workstream (WHATWG).
DOM (#element-custom-element-registry), from DOM Workstream (WHATWG).

Browser support

Chrome ❌
Chrome Android ❌
Edge ❌
Firefox ❌
Firefox for Android ❌
Safari 26 Released on 2025-09-15
Safari on iOS 26 Released on 2025-09-15

Web Platform Tests (WPT)

View the latest WPT test results for this feature

Developer signals

Votes: 0

If you want this feature to be available in all browsers, vote for it by adding a thumbs up reaction (👍) to this GitHub issue, and leave a comment with more information.

View as JSON | Edit this feature | Report an issue | Web-features entry: source, dist