Choose a design system
Switch the portal between Cobalt, Neutral and your organisation's design systems, and see what changes.
The portal shows one design system at a time. Pick the one you build with, so foundations, brand rules and templates match your product.
What you can choose
- Built in: Cobalt, the base, with cobalt blue actions and a header with the sections as links, and Neutral, monochrome with side navigation and no logo, for white-label products and demos. Everyone can use both.
- Your organisation: when you are signed in to an organisation, its published design systems. Designers and above also see drafts, marked draft.
Switch design system
- In the top bar, select Design system (it shows the current one's name).
- Choose a design system from the list. A tick marks the current one.
On a phone, open Open menu: the design systems are listed at the top. In search (⌘K, Ctrl K or /), Use
followed by a design system's name switches to it.
Your choice is remembered in this browser.
What changes, and what stays the same
| Changes with the design system | Same in every design system |
|---|---|
| Foundations: colour, elevation, space and shape | Components and their props |
| Brand: the logo and how to use it | AI elements |
| The templates offered, and their app frame | Guidelines, icons and Weave |
| Colours in component and template previews | Token names (each design system gives them its values) |
Because only foundations, the frame and the logo change, a screen is written once and works in every design system.
Where you start
Until you choose, the portal shows your organisation's default design system if you are a member (its admins set it), and Cobalt otherwise. Once you choose, your choice wins while you can still use it.
Use it in your product
The design system you pick here only changes the portal. To set it in a product, see Use your design system. Members can open Manage design systems from the bottom of the list to see their organisation's design systems.
If something goes wrong
| What you see | What to do |
|---|---|
| Your organisation's design systems aren't listed | Sign in, and check you are working in the right organisation. See Switch organisations. |
| A draft you expected isn't listed | Drafts are shown to designers, publishers and admins only. |
| The portal went back to Cobalt or your organisation's default | You chose a design system you can no longer use, such as one in another organisation. Your choice comes back when you can use it again. |