Business Manager Redesign

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.

1. Update @wix/design-system

The redesigned component styles ship in recent releases. Update to the latest version:

Copy

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.

2. Update @wix/wix-ui-icons-common

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:

Copy

Update both packages together. The latest components expect the matching icon set.

3. Set up the theme in your app

Your app runs in an iframe, so it doesn't get theme styles from the Business Manager. Set up the theme as follows:

  1. Load the theme tokens. Import the odeditor token stylesheet together with the base styles. Other loading options, such as CDN links, are described in Theming.
  2. Add the icon theming providers. Wrap your app with WixDesignSystemIconThemeProvider and IconThemeProvider so that icons use the new icon set. See Icon Theming for details.
  3. Apply the Business Manager defaults. Wrap your app with WixDesignSystemDefaultPropsProvider to set the redesign's default sizes and skins. Props set on an individual component still override them.

All three combined:

Copy

4. Import icons from the lazy entry point

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:

Copy

You can migrate imports incrementally, screen by screen. Icons imported from the root keep rendering in the classic style until you update them.

5. Apply manual adjustments

Some components need manual changes to match the redesign. The full list is in section 6 of the Harmony theme guidelines. In short:

ComponentAdjustment
AccordionChange the chevron manually
Panel and modal headersUpdate the close button and use the tiny size for the question mark icon
Modal footersReplace the secondary button with a text button at M size, use the light footer skin and remove the divider
SliderSet horizontal spacing to 12px instead of 8px
Components with built-in buttonsChange the nested icon button to Dark / Tertiary
TabsUse the small size and turn the divider off
Angle inputChange 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:

  • Standalone text buttons use the standard (blue) skin. A text button next to a primary or secondary button uses the Dark skin.
  • Panels, cards and modals no longer have dividers in their headers and footers. Keep them removed.
  • Empty states use typography only. Remove legacy illustrations.

6. Replace custom styles with design tokens

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:

  • Hardcoded values with --wds-* design tokens
  • Inline style 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.

Verify your app

  • Confirm your app loads the design system styles and theme tokens correctly, as described in Theming.
  • Inspect a component in the browser developer tools. Its colors should resolve from --wds-* custom properties. A hardcoded value means the element still uses custom styling.
  • Check every interactive and feedback state: hover, focus, disabled, selected, error, warning and success.
  • Check custom code that reads colors in JavaScript. Design tokens are CSS custom properties, so values copied into JavaScript objects don't change with the theme.

Last updated: 21 October 2026

Did this help?