The Harmony theme is the visual language introduced with Editor 3.0 and rolled out across Business Manager. It is a modern, friendly workspace aligned with today's industry standards, and it reflects three core principles: approachable, intuitive and fun.
The interface embraces a tactile, material-inspired design. Subtle textures, layers and shadows create a crafted sense of depth: buttons rise for clarity, inputs are gently inset for precision, and dividers appear as engravings. This balance of raised and recessed elements makes the workspace feel natural, guided and playful.
In code, the Harmony theme is the odeditor theme (and odeditor-dark for its dark counterpart). Everything on this page is expressed through that theme's tokens. Use tokens rather than hard-coded values so the same markup renders correctly in every theme.
Harmony uses two Madefor families.
Wix Madefor Display: wider, with more generous proportions. Added specifically as a heading font, and used only in titles and headers (mostly panel headers and modal titles). Sizes: 32 / 24 / 16 px.
Wix Madefor Text: designed for a smooth reading experience. Sizes: 14 / 12 px. Note that "bold" now renders with the semibold weight.

Rules
Panel type scale
| Role | Size / weight |
|---|---|
| Panel header | 16px Display / Bold |
| Section header | 14px Semibold |
| Field label | 12px Medium |
| Control value | 14px Regular |
| Link ("More text options") | 14px |


Harmony has two primary ramps, Blue and Black / greyscale, plus a set of system ramps.

Blue: --wds-color-blue-*
| Step | Hex |
|---|---|
| Color 0 | #0F2CCF |
| Color 50 | #1C3FE5 |
| Color 100 | #2F5DFF |
| Color 200 | #597DFF |
| Color 250 | #829EFF |
| Color 300 | #ACBEFF |
| Color 400 | #D5DFFF |
| Color 500 | #E0E7FF |
| Color 600 | #EAEFFF |
Black / greyscale: --wds-color-black-*
| Step | Hex |
|---|---|
| Color 100 | #151414 |
| Color 200 | #383838 |
| Color 300 | #525150 |
| Color 400 | #767574 |
| Color 500 | #A8A6A5 |
| Color 550 | #DEDEDE |
| Color 600 | #E8E7E7 |
| Color 700 | #F0EFEF |
| Color 750 | #F8F6F6 |
Blue is the primary action colour in the Harmony theme. Throughout the Editor, all primary action buttons use the standard blue styling. Most controls in panels also use blue as their default interactive colour, creating a consistent and recognisable interaction pattern across the product.

Black is the primary action colour in Business Manager, and is what the Dark button skin renders. Across the Harmony Editor it is also applied to supporting UI: tooltips, toast messages, tertiary icon buttons and badges. Use black consistently for these patterns to maintain a clear visual hierarchy and a cohesive UI language.

| Role | Token value |
|---|---|
| Primary text | Grey 100, #151414 |
| Secondary text | Grey 400, #767574 |
| Disabled / tertiary text | Grey 500, #A8A6A5 |

Harmony ships red, orange, yellow and green system ramps for status and feedback.

| Ramp | Steps 0 → 500 |
|---|---|
| Orange | #AE3E09, #D96D3A, #FF8044, #FE9361, #FDA77F, #FBCFBB, #FBE3D9, #FDF1EC |
| Green | #0D4F3D, #11664F, #4B916D, #97C693, #BDE2A7, #DAF3C0, #EFFAE5, #F1F5ED |

Implementation note. Reference --wds-color-* tokens, never the hex values above. The specification and the shipped odeditor theme have drifted in a few places. The deck's step names for the lighter end of the system ramps are one step lower than the tokens' (spec 250 = token 300, and so on). The blue ramp's 250/500/600 values differ from the shipped tokens, and the red and yellow ramps were never given hex values in the specification. Confirm with the Design System team before relying on a specific step.
Four elevation levels, mapped to semantic tokens.
| Level | Token | Applies to |
|---|---|---|
| Raised | --wds-shadow-surface-raised | Cards |
| Overlay | --wds-shadow-surface-overlay | Panels, dropdown lists, popover menus, light tooltips |
| Overlay dark | --wds-shadow-surface-overlay-dark | Dark tooltips, dark popovers |
| Modal | --wds-shadow-surface-modal | Modals |


| Radius | Token | Applies to |
|---|---|---|
| 24px | --wds-border-radius-1200 | Modals, panels and large images |
| 12px | --wds-border-radius-600 | Modals, panels, large images, clickable cards |
| 8px | --wds-border-radius-400 | Buttons and inputs |
| 6px | --wds-border-radius-300 | Tiny buttons, only for optical alignment |

Harmony icons are drawn with 1.5px strokes, in 18px and 24px sizes. The heavier stroke is what lets icons sit optically level with semibold text when used as a prefix or suffix.


Mix icons from other libraries. Use icons exclusively from the dedicated Harmony Icons library, otherwise stroke weights and optical sizes stop matching across the product.
Four heights, matching the Button size prop in the odeditor theme.
| Height | size |
|---|---|
| 46px | large |
| 38px | medium |
| 30px | small |
| 24px | tiny |

M (38px) is the default for buttons and inputs inside panels. Business Manager uses Small as its default button size.

Beyond the standard blue, three additional skins are available: Dark, Alert and Premium.

premium skin rather than restyling a standard button, so the whole product changes together when the premium style changes.A new button type. Tertiary buttons can be used alongside primary and secondary buttons as an alternative to text buttons, and give more distinct hover and pressed states. They are currently used in modal and panel footers, but can be adopted in any similar interaction pattern.

There are three ToggleButton skins.
| Skin | Where to use |
|---|---|
| Standard (Main) | General use, all panels |
| Dark (Stage) | Stage environment only: top bar, action bar, and tools |
| Inverted (Stage) | Stage environment only: top bar, action bar, and tools |

The Dark and Inverted skins are reserved for the stage environment and shouldn't be used for anything else.
The default input and button size in panels is M (38px).

Some panel spacing is given by the components and can't be changed; the rest has to be set manually.
| Spacing | Where | Source |
|---|---|---|
| 8px | Below the panel header, before the first item | Manual |
| 4px | Between tightly grouped controls | Manual |
| 24px | Between panel sections | Given |
| 16px | Panel content padding, and the gap before the panel end | Given |

When a footer isn't used in a panel, leave at least 16px of space before the end of the panel.
Use accordions to group elements together in a panel. Legacy panels may still use section headers; the section header look has been aligned with the accordion component to create a more cohesive experience.

Two SectionHeader skins are in use, Light (main) and Neutral. Use them without dividers. Dividers may be used only where many list items or other assets create a critical need for extra separation.

Floating panels come in four fixed widths. Height is fixed to the screen size, minus padding.
| Size | Width |
|---|---|
| XS | 240px |
| S | 288px |
| M | 420px |
| L | 560px |

In edge cases, mainly language-driven ones where labels get long, a footer can stack one button above the other. Only do this for panels that don't contain much content, since it creates a very thick footer.

To assemble a panel header and footer correctly:
tiny size for the question mark icon. This adjusts the header height.
If text is needed under the header, put it in the panel body and remove the top spacing from a side panel field. Use 12px regular in Grey 400. A short paragraph with its own 12px semibold black title is possible but not advised.


Use the header subtitle for additional text. Put the text in the panel body instead. This also applies to modals.
SidePanel padding is given: 16px around the content, with 4px at the footer edge. As with floating panels, when there's no footer leave at least 16px before the end of the panel.

Side panel behaviour depends on the viewport. On wide screens the panel docks beside the content, which keeps its full width. As the viewport narrows the panel overlays the content instead.


By default the modal component renders S size buttons and a primary/secondary pair. Harmony instead calls for a text button in place of the secondary, at M size. This change has to be made manually.


| Popover type | Padding |
|---|---|
| Text-based | 24px, aligned with modal padding |
| Opens a controller | 16px, aligned with panel padding |



In panels: wrap TableListItem in NestableList. NestableList provides the required layout and guarantees 8px padding from the panel edges, instead of letting list items stretch edge to edge. Remove the blue selected indicator and use the checkbox as the only selection indicator.

In tables: use the non-rounded variant and extend edge to edge. The blue selection indicator is used only in table layouts.

Dividers have been intentionally removed from the headers and footers of panels, cards and modals. Don't add them back in any of these components.
In general, use dividers only when necessary. Prefer spacing to create separation. Dividers are appropriate in cases such as accordions, complex tables, or panel sections where spacing alone doesn't provide enough distinction.

The Harmony theme doesn't yet include an illustration language. Until one is introduced, remove all legacy illustrations and use typography-only empty states.
Page level: place the content inside a card that spans the maximum available width and height.

Card level: use the section skin property for a smaller title.

If a call to action is required, use one of these combinations:
showShadow for top-level cards placed directly on the workspace.
Several components don't yet default to their Harmony styling. These have to be adjusted by hand.
Accordion: the chevron needs to be changed manually.

Panel and modal close buttons: change the close button in every panel and modal header.
Slider: horizontal spacing is an exception, because the knob steps outside the slider's boundaries. Set it manually to 12px instead of 8px.

Components with built-in buttons: change the icon button to Dark / Tertiary.

Tabs: use the small size as the default. The first tab uses fake padding for alignment. Turn the divider off.

Angle input: change to medium (38px height) manually.
Fill preview: FillPreview supports opacity and multicolour selections: two, three and four colour selections, with or without opacity.

Last updated: 21 October 2026