Icons in @wix/wix-ui-icons-common/lazy can render in different shapes depending on which Wix editor (Classic, Studio, Blocks, Harmony) they appear in. The same applies to other microfrontend-based products such as Wixel. Instead of bundling every variant, lazy icons fetch their SVG paths from the CDN at runtime and pick the right one for the active theme.
Two providers configure how icons resolve. Consumers typically render both near the root of their app:
| Provider | Source | Purpose |
|---|---|---|
IconThemeProvider | @wix/wix-ui-icons-common/core | Selects which icon variant lazy icons fetch (default or odeditor). |
WixDesignSystemIconThemeProvider | @wix/design-system | Registers the lazy icons used internally by WDS components (Button, Modal, CloseButton, etc.). |
Minimal setup:
If neither provider is mounted, WDS components still render with their static (eager) icons in the default style.
For the full architecture (CDN layout, cache invalidation, render flow, type safety, how WDS components wire up useIcons), see the internal Icon Theming guide.
Last updated: 15 October 2026