Harmony Theme

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.

1. Foundations

1.1 Typography

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.

The Madefor Display and Madefor Text families with their available sizes

Rules

  • The primary text size is 14px. Don't use 16px anywhere other than panel headers.
  • A semibold weight was added. Use it mostly for section headers and buttons, so text aligns optically with the 1.5px icons used as prefix/suffix.

Panel type scale

RoleSize / weight
Panel header16px Display / Bold
Section header14px Semibold
Field label12px Medium
Control value14px Regular
Link ("More text options")14px

Type scale annotated on a settings panel

Text sizes measured across a panel

1.2 Colour

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

The Harmony blue and greyscale ramps

Blue: --wds-color-blue-*

StepHex
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-*

StepHex
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

Where blue is used

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.

Blue applied to primary buttons and panel controls

Where black is used

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.

Black applied to tooltips, toasts, badges and tertiary icon buttons

Greyscale in typography

RoleToken value
Primary textGrey 100, #151414
Secondary textGrey 400, #767574
Disabled / tertiary textGrey 500, #A8A6A5

Greyscale applied to headings, body copy and menu items

System colours

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

The red, orange, yellow and green system ramps

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

System colours applied to a section helper, a status indicator and a toast

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.

1.3 Shadows

Four elevation levels, mapped to semantic tokens.

LevelTokenApplies to
Raised--wds-shadow-surface-raisedCards
Overlay--wds-shadow-surface-overlayPanels, dropdown lists, popover menus, light tooltips
Overlay dark--wds-shadow-surface-overlay-darkDark tooltips, dark popovers
Modal--wds-shadow-surface-modalModals

The four Harmony elevation levels

Each elevation level applied to a real surface

1.4 Corner radius

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

The four corner radius values with examples

1.5 Icons

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.

The same icon at the old 1px stroke and the new 1.5px stroke

The Editor icon set at 18px, drawn from the Harmony Icons library

Don't

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.

2. Buttons

2.1 Sizes

Four heights, matching the Button size prop in the odeditor theme.

Heightsize
46pxlarge
38pxmedium
30pxsmall
24pxtiny

Primary, secondary, text, icon and prefix/suffix buttons at all four sizes

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

2.2 States

Default, hover, clicked and disabled states for each button type

2.3 Skins

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

The Dark, Alert and Premium button skins

  • The premium colour for buttons is now blue. Always use the premium skin rather than restyling a standard button, so the whole product changes together when the premium style changes.
  • Dark is the primary button style in Business Manager (Small size).
  • For tertiary icon buttons, the Dark variant is the default across both the Editor and Business Manager.

2.4 Tertiary buttons

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.

Tertiary buttons in a panel footer, with the priority property set to Tertiary

2.5 Toggle buttons

There are three ToggleButton skins.

SkinWhere 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

Toggle button skins across default, hover, selected and hover-selected states

The Dark and Inverted skins are reserved for the stage environment and shouldn't be used for anything else.

3. Panels

3.1 Inputs & controllers

The default input and button size in panels is M (38px).

M-size inputs and controllers in a settings panel

3.2 Spacing

Some panel spacing is given by the components and can't be changed; the rest has to be set manually.

SpacingWhereSource
8pxBelow the panel header, before the first itemManual
4pxBetween tightly grouped controlsManual
24pxBetween panel sectionsGiven
16pxPanel content padding, and the gap before the panel endGiven

Panel spacing, split into manual and given values

When a footer isn't used in a panel, leave at least 16px of space before the end of the panel.

3.3 Grouping

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.

Accordion grouping next to a legacy section header

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.

Section header light, section header neutral, and section header with a divider

3.4 Panel sizes

Floating panels come in four fixed widths. Height is fixed to the screen size, minus padding.

SizeWidth
XS240px
S288px
M420px
L560px

The four floating panel widths

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.

A panel footer with stacked buttons

To assemble a panel header and footer correctly:

  • Header: choose the standard filled skin for the close button, and the tiny size for the question mark icon. This adjusts the header height.
  • Footer: remove the divider. In small panels, adjust the buttons to fill the container width.

Panel header and footer adjustments

3.6 Text under the header

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.

Short paragraph under a panel header, with and without a title

Body text under the header instead of a header subtitle

Don't

Use the header subtitle for additional text. Put the text in the panel body instead. This also applies to modals.

3.7 Side panels

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 given padding

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.

Side panel docked beside content at a 1440px viewport

Side panel overlaying content at a 1248px viewport

4. Modals & popovers

4.1 Modal buttons

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.

Modal footer with a text button replacing the secondary button

4.2 Modal adjustments

  • Update the close button and question mark manually, the same way as in panel headers.
  • Use 24px padding in all custom and announcement modals.
  • Change the footer to the light skin manually.

Modal close button, padding and footer skin adjustments

4.3 Popover padding

Popover typePadding
Text-based24px, aligned with modal padding
Opens a controller16px, aligned with panel padding

Text-based and controller popovers with their respective padding

5. Business Manager defaults

5.1 Buttons

  • Dark buttons are the primary button style in Business Manager, at Small size.
  • Text buttons use the standard (blue) skin when they stand alone.
  • When a text button appears alongside a primary or secondary button, use the Dark skin instead. This happens in a panel footer or a marketing card, for example.
  • Use tertiary icon buttons (Dark) rather than secondary buttons for row-level actions.

Dark primary buttons paired with dark tertiary and dark secondary buttons

Blue standalone text buttons, dark primary buttons and dark tertiary icon buttons in a table page

5.2 Table list items

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.

Table list items nested inside a panel with 8px padding

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

Table list items extending edge to edge in a table, with the blue selection indicator

5.3 Dividers

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.

Cards and panels without header or footer dividers

5.4 Empty states

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.

A page-level empty state inside a full-width, full-height card

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

A card-level empty state using the section skin

If a call to action is required, use one of these combinations:

  • Single text button (Small)
  • Single primary button (Small)
  • Text button pair (Small)
  • Primary button (Small) + text button (Tiny) pair

5.5 Cards

  • Cards with a header use the component's default 24px padding.
  • Cards without a header. Remove the component padding and apply spacing in the content instead. In the example below the inner content defines 12px padding.
  • Use showShadow for top-level cards placed directly on the workspace.
  • Use the Border skin for nested cards, to maintain a clear visual hierarchy.

Card padding and prop combinations on a Business Manager page

6. Manual adjustments checklist

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.

Accordion chevron adjustment

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.

Slider horizontal spacing set to 12px

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

A nested icon button changed to dark tertiary

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

Small tabs without a divider in a colour picker panel

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.

Fill preview opacity and multicolour variants


Last updated: 21 October 2026

Did this help?