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

Publish a design system

Make a draft live for products, return to an earlier revision, deprecate or restore it, and change its address.

For publishers and admins2 min read

Products only ever load published revisions of a design system; the draft stays with your designers until then. You need the publisher role or above for most of what follows. Open the design system from Manage design systems (/brands) and choose the Publish tab.

Publish the draft

  1. Open Checks and make sure nothing fails. Publishing is refused while any accessibility check fails in light, dark or either high-contrast mode.
  2. On Publish, choose Publish this draft.

Each publish keeps a revision. Products on the latest address get it within a minute, without a rebuild. When the draft matches the live revision, the panel says so: change something to publish again.

Return to an earlier revision

Under Revisions, each one shows who published it and when; the live one is marked live. Choose Make live on another revision and confirm. Products on the latest address switch to it within a minute. Pinned addresses don't change.

Deprecate or restore

Under For products already using it, choose Deprecate and confirm. Products using it keep working and its stylesheet keeps loading; members and agents see it as deprecated.

If it is your organisation's default design system, members stop starting in it: the default goes back to Cobalt, and an admin has to choose it again (see Choose the default design system).

Choose Restore to bring it back.

Give it a new stylesheet address

If the stylesheet address leaked, choose New stylesheet address and confirm. Products loading the old address stop getting the design system until they switch to the new one, so tell the teams that use it.

Delete a draft

A design system that was never published can be deleted, by designers too: choose Delete draft under Delete. Its settings and files go. Published design systems can't be deleted, because live products may use them; deprecate them instead.

Check it on real pages

Where the portal runs accessibility checks, a published design system has Check accessibility in its top bar. It checks the portal's own pages in this design system's live revision. See Read check results.

If something goes wrong

If something goes wrong
What you seeWhat to do
No Publish this draft buttonYou need the publisher role. Ask your admin.
"Not published" with "Fix these before publishing"Open Checks, use Fix or Fix all, then publish again.
"The draft couldn't be saved, so it wasn't published"Check your connection, wait for "Draft saved", then publish again.
"Brand files are published with the portal"This design system comes from the portal's brands folder and changes through git.