The Business Manager (Wix Site Dashboard) was redesigned with the Harmony theme. Apps run inside an iframe, so they don't inherit the new theme from the platform. Apply a few updates on your side to complete the migration.
Follow the steps below. Steps 1 to 4 are code changes. Steps 5 and 6 need a design review.
The redesigned component styles ship in recent releases. Update to the latest version:
Keep the package up to date during the rollout. Style refinements ship continuously, so an older version can leave your app with a partial redesign.
The redesign introduces a new icon set, drawn with 1.5px strokes at 18px and 24px. It is available in recent releases of the icon library:
Update both packages together. The latest components expect the matching icon set.
Your app runs in an iframe, so it doesn't get theme styles from the Business Manager. Set up the theme as follows:
odeditor token stylesheet together with the base styles. Other loading options, such as CDN links, are described in Theming.WixDesignSystemIconThemeProvider and IconThemeProvider so that icons use the new icon set. See Icon Theming for details.All three combined:
Icons imported from the package root always render in the classic style. Icons imported from the lazy entry point render in the style selected by the providers from step 3. In Business Manager they render the new icon set. In other environments they keep the current one.
Update your imports:
You can migrate imports incrementally, screen by screen. Icons imported from the root keep rendering in the classic style until you update them.
Some components need manual changes to match the redesign. The full list is in section 6 of the Harmony theme guidelines. In short:
| Component | Adjustment |
|---|---|
| Accordion | Change the chevron manually |
| Panel and modal headers | Update the close button and use the tiny size for the question mark icon |
| Modal footers | Replace the secondary button with a text button at M size, use the light footer skin and remove the divider |
| Slider | Set horizontal spacing to 12px instead of 8px |
| Components with built-in buttons | Change the nested icon button to Dark / Tertiary |
| Tabs | Use the small size and turn the divider off |
| Angle input | Change to medium (38px height) |
Business Manager also has its own defaults, described in section 5 of the same page. The provider from step 3 covers the button and input defaults. The rest need attention in your layouts:
Hardcoded values don't update with the theme. A hardcoded color or font size keeps its old value while the components around it change, which makes a page look half migrated.
Replace the following:
--wds-* design tokensstyle overrides on components with the matching skin or size props.The Token Migration Guidelines describe the process and include token mapping tables. A plain markdown version of that page is available to share with an AI coding assistant.
--wds-* custom properties. A hardcoded value means the element still uses custom styling.Last updated: 21 October 2026