Icon Theming

1. Introduction

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.

2. Providers

Two providers configure how icons resolve. Consumers typically render both near the root of their app:

ProviderSourcePurpose
IconThemeProvider@wix/wix-ui-icons-common/coreSelects which icon variant lazy icons fetch (default or odeditor).
WixDesignSystemIconThemeProvider@wix/design-systemRegisters the lazy icons used internally by WDS components (Button, Modal, CloseButton, etc.).

Minimal setup:

Copy

If neither provider is mounted, WDS components still render with their static (eager) icons in the default style.

3. Going deeper

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

Did this help?