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

## Article: Harmony Theme

## Article Link: https://dev.wix.com/docs/wix-design-system/guidelines/themes/harmony-theme.md

## Article Content:

<!-- heading -->


# Harmony Theme


<!-- end heading -->


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/8a361ab5970620dc15dc127aa563ef0c.png)


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


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


![Type scale annotated on a settings panel](https://wixmp-833713b177cebf373f611808.wixmp.com/images/a174f6dbd843c4e6cd780d89323f434f.png)


![Text sizes measured across a panel](https://wixmp-833713b177cebf373f611808.wixmp.com/images/401fdf90a47e6e42bc3faf237e7097f3.png)


### 1.2 Colour


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


![The Harmony blue and greyscale ramps](https://wixmp-833713b177cebf373f611808.wixmp.com/images/55e01e0db848f1bd227b3a9091ca6f47.png)


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


#### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/59692259f4bf27432a56c46983ac167f.png)


#### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/415f3e688a360728562ce21fc349b9e4.png)


#### Greyscale in typography


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


![Greyscale applied to headings, body copy and menu items](https://wixmp-833713b177cebf373f611808.wixmp.com/images/28d993e4cc11696f5bf1ff0cf5be1c4d.png)


#### System colours


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


![The red, orange, yellow and green system ramps](https://wixmp-833713b177cebf373f611808.wixmp.com/images/89ff010cee2a3b832d105a65e2e86c9c.png)


| Ramp | Steps 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/b28f3ab4e157dd914d14505679bb92fd.png)


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


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


![The four Harmony elevation levels](https://wixmp-833713b177cebf373f611808.wixmp.com/images/e1f12efc5a3cb92798f27ad882850dd0.png)


![Each elevation level applied to a real surface](https://wixmp-833713b177cebf373f611808.wixmp.com/images/6adf0bf7ac158b8806c3eac6fadf7428.png)


### 1.4 Corner radius


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


![The four corner radius values with examples](https://wixmp-833713b177cebf373f611808.wixmp.com/images/9d595c2e2e21460083655723edb12fcd.png)


### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/22d17cd133ccb0ea46c58b0528bcebb0.png)


<!-- dodont -->
<!-- dodont image -->
![The Editor icon set at 18px, drawn from the Harmony Icons library](https://wixmp-833713b177cebf373f611808.wixmp.com/images/6ad8d770633b77c8e96baeda09434607.png)
<!-- end dodont image -->
<!-- dodont content -->
#### 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.
<!-- end dodont content -->
<!-- end dodont -->


## 2. Buttons


### 2.1 Sizes


Four heights, matching the [Button](#/component/button) `size` prop in the `odeditor` theme.


| Height | `size` |
| --- | --- |
| 46px | `large` |
| 38px | `medium` |
| 30px | `small` |
| 24px | `tiny` |


![Primary, secondary, text, icon and prefix/suffix buttons at all four sizes](https://wixmp-833713b177cebf373f611808.wixmp.com/images/15262dd4f29e9da24c958a72109da372.png)


**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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/f8cfee7dcad13f2dbd98f32aec240982.png)


### 2.3 Skins


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


![The Dark, Alert and Premium button skins](https://wixmp-833713b177cebf373f611808.wixmp.com/images/15212704ddaa47482cbb8693597d96e8.png)


* 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/df0ec44ebf428a69663698be5c6604cd.png)


### 2.5 Toggle buttons


There are three [ToggleButton](#/component/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 |


![Toggle button skins across default, hover, selected and hover-selected states](https://wixmp-833713b177cebf373f611808.wixmp.com/images/84791a1f849af5100640cfa888cf6bf6.png)


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/2617aa27c80d9c16175454c4b9c526cf.png)


### 3.2 Spacing


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 |


![Panel spacing, split into manual and given values](https://wixmp-833713b177cebf373f611808.wixmp.com/images/a4609fe5e442fcb3cf360f8ca779cff1.png)


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/80398b7509ae68957d3b965150bf9d5f.png)


Two [SectionHeader](#/component/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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/f133f3a1b0fa616c5e9530980bb63ed5.png)


### 3.4 Panel sizes


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 |


![The four floating panel widths](https://wixmp-833713b177cebf373f611808.wixmp.com/images/f45409d88beb1dd0b4043016f02a76ed.png)


### 3.5 Header & footer


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/dcb4017e27f8a9ffec7aaf339240a659.png)


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/4a92bf972ba7a609580011e83b528f68.png)


### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/b843a03c81d5fd22b4ccbb398a838045.png)


<!-- dodont -->
<!-- dodont image -->
![Body text under the header instead of a header subtitle](https://wixmp-833713b177cebf373f611808.wixmp.com/images/4e968ec7f3b4eb69cc03f238a1b57e7a.png)
<!-- end dodont image -->
<!-- dodont content -->
#### Don't
Use the header subtitle for additional text. Put the text in the panel body instead. This also applies to modals.
<!-- end dodont content -->
<!-- end dodont -->


### 3.7 Side panels


[SidePanel](#/component/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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/2d89715f754a8fbe6630c65c24e85342.png)


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/2094dfb8b939d1c985705a00b853ae7a.png)


![Side panel overlaying content at a 1248px viewport](https://wixmp-833713b177cebf373f611808.wixmp.com/images/f12c2b0fe9fb4572678203030e07d86b.png)


## 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/fd57f4e6f3d0195a8c356d4089bad647.png)


### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/8f2cfaa6941e1a1628c6c41eb1485a57.png)


### 4.3 Popover padding


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


![Text-based and controller popovers with their respective padding](https://wixmp-833713b177cebf373f611808.wixmp.com/images/39522c74d0e1e71fb0c0d61d834783cb.png)


## 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/bfb599fea73e8d43848cafc57c532705.png)


![Blue standalone text buttons, dark primary buttons and dark tertiary icon buttons in a table page](https://wixmp-833713b177cebf373f611808.wixmp.com/images/76e4649872ea9861e68fdc1590370ce8.png)


### 5.2 Table list items


**In panels**: wrap [TableListItem](#/component/tablelistitem) in [NestableList](#/component/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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/0f95e29b693e367572cb8065ccbc184e.png)


**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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/826c025609e44c12c19bf07d60a2fc8e.png)


### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/40644b63f2874f9057b57e6259b34eb9.png)


### 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/e68b36cf79094d33de418f2390769a0d.png)


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


![A card-level empty state using the section skin](https://wixmp-833713b177cebf373f611808.wixmp.com/images/cc234692b03c0f88fad21767a1f90d48.png)


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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/d6d19cbcfc69a3ca550eb9ff6555b7e9.png)


## 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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/80548906440e94a36022071cb814c4f7.png)


**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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/7dc9e1e7412e59e4debca4cb3eb2cf28.png)


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


![A nested icon button changed to dark tertiary](https://wixmp-833713b177cebf373f611808.wixmp.com/images/df4914c36f55c204966bbeeeda57a046.png)


**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](https://wixmp-833713b177cebf373f611808.wixmp.com/images/351b64d67c003caacdcf904c54fe7214.png)


**Angle input**: change to medium (38px height) manually.


**Fill preview**: [FillPreview](#/component/fillpreview) supports opacity and multicolour selections: two, three and four colour selections, with or without opacity.


![Fill preview opacity and multicolour variants](https://wixmp-833713b177cebf373f611808.wixmp.com/images/3cf45b01e6e8b73b9ca7b3967580ba91.png)


---


## Related components


* [Button](#/component/button)
* [IconButton](#/component/iconbutton)
* [TextButton](#/component/textbutton)
* [ToggleButton](#/component/togglebutton)
* [Card](#/component/card)
* [SectionHeader](#/component/sectionheader)
* [EmptyState](#/component/emptystate)
* [Divider](#/component/divider)
* [Accordion](#/component/accordion)
* [NestableList](#/component/nestablelist)
* [TableListItem](#/component/tablelistitem)
* [Tabs](#/component/tabs)
* [SidePanel](#/component/sidepanel)
* [Popover](#/component/popover)
* [CustomModalLayout](#/component/custommodallayout)
* [AnnouncementModalLayout](#/component/announcementmodallayout)
* [Slider](#/component/slider)
* [AngleInput](#/component/angleinput)
* [FillPreview](#/component/fillpreview)


## Related guidelines


* [Studio 2.0 theme](#/page/guidelines/studio2theme)
* [Panel layout](#/page/guidelines/settingspanel)
* [Modals and overlays](#/page/guidelines/modals)