Skip to content
Agentic Experience Design Language Help Go to the portal

Choose a design system

Switch the portal between Cobalt, Neutral and your organisation's design systems, and see what changes.

For everyone2 min read

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

  1. In the top bar, select Design system (it shows the current one's name).
  2. 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

What changes, and what stays the same
Changes with the design systemSame in every design system
Foundations: colour, elevation, space and shapeComponents and their props
Brand: the logo and how to use itAI elements
The templates offered, and their app frameGuidelines, icons and Weave
Colours in component and template previewsToken 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

If something goes wrong
What you seeWhat to do
Your organisation's design systems aren't listedSign in, and check you are working in the right organisation. See Switch organisations.
A draft you expected isn't listedDrafts are shown to designers, publishers and admins only.
The portal went back to Cobalt or your organisation's defaultYou 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.