> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Icon Theming

## Article: Icon Theming

## Article Link: https://dev.wix.com/docs/wix-design-system/foundations/icon-theming.md

## Article Content:

<!-- heading -->

# Icon Theming

<!-- end heading -->

## 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:

| 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:

<!-- grid layout -->
<!-- grid layout item -->
<!-- grid layout content -->

```jsx
import {
  CloseButton,
  WixDesignSystemIconThemeProvider,
} from '@wix/design-system';
import { IconThemeProvider } from '@wix/wix-ui-icons-common/core';

export default function App() {
  return (
    <WixDesignSystemIconThemeProvider>
      <IconThemeProvider theme="odeditor">
        <CloseButton />
      </IconThemeProvider>
    </WixDesignSystemIconThemeProvider>
  );
}
```

<!-- end grid layout content -->
<!-- end grid layout item -->
<!-- end grid layout -->

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](invalid-url).