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

Create a design system for your organisation

Start a draft from scratch or from your own token files, review what was read, and finish it in Design System Studio.

For designers, publishers and admins2 min read

Your organisation's design systems sit on top of the design language and change only its look: colours, typeface, corners, density, logos and icons. You need the designer role or above, and your organisation's plan must include design systems of its own.

Start a new one

  1. Open Manage design systems (/brands) and choose New design system.
  2. Under How to start, choose From scratch, Import files or From Figma (see Import from Figma).

Nothing is published until a publisher does it. Only your organisation's designers and above see a draft.

From scratch

  1. Enter a Name, such as the brand or product it's for.
  2. Check the Id. Products use it as data-brand="acme". It is lowercase letters, digits and hyphens, starts with a letter, and can't change later.
  3. Add a Description (optional) so people know which one this is.
  4. Choose Create. Design System Studio opens on Start.

From files

  1. Choose Import files, or drop files on the area. You can bring design tokens, Tokens Studio files, CSS, a brand zip, or a zip with fonts, logos and icons. Files are read in your browser; nothing is uploaded yet.
  2. On Review the import, check each part:
    • What was found: what the portal read, and which set is the light and the dark mode.
    • Left out, and why: values it couldn't use, and fonts to add yourself.
    • Not placed yet: choose Place to put a value where it belongs, or leave it out.
    • Files found: tick Include the … font files, and confirm you may use and embed them.
    • The result: the preview and any failing contrast checks. Apply suggested colours offers colours that pass.
  3. Under Create the design system, set the Name and Id (a brand zip brings its own), then choose Create design system.

Finish it in Design System Studio

The studio saves your draft as you go. Work through its tabs: Design, Type, Brand artefacts (logos, favicon, wordmarks), Icons, Templates (the ones agents use first), Tokens and Checks. Before your first upload, confirm that your organisation may use the fonts, logos and icons.

When every check passes, ask a publisher to publish it.

If something goes wrong

If something goes wrong
What you seeWhat to do
"You can't create design systems here"Ask your admin for the designer role, or your operator to add design systems to your plan.
"Lowercase letters, digits and hyphens, starting with a letter"Change the id to match.
"Nothing here that the portal reads"Choose other files: tokens JSON, CSS or a zip.
"The draft … was created, but … didn't make it"Choose Open it anyway and add the missing files in the studio, or Delete the draft and try again.
"Brand files are read-only here"Choose More actions › Duplicate for an editable copy.