Set up your organisation
Work through the Getting started checklist so your members can use your design systems in their products and tools.
As an organisation admin, you set up your organisation once so that everyone else can start work. The portal's home page shows a checklist, Getting started with the design language, until the required steps are done.
Where to find it
Sign in to the portal and open the home page. The checklist sits under the opening section and says how many steps are done. Each step that is left links to where you do it. The checklist shows only to admins, and goes away once every required step is done.
All the settings it links to are in Organisation settings: open the account menu, or More › Organisation settings (/admin).
The steps
- People invited. Invite the people who design, publish and use your design systems, each with a role. See Invite people and choose their roles.
- Allowed sites added. List the sites your products run on, so your design systems' fonts and files load there. See Allowed sites.
- A design system published. A designer creates one under Manage design systems (
/brands), and a publisher publishes it. See Create a design system and Publish a design system. - Tools connected. Someone creates an access token, or signs in to Design Language Connect, so AI tools, Figma and CI can use your design systems. See Install Design Language Connect and Access tokens.
Two steps are optional and never keep the checklist showing:
- Company sign-in connected. Members sign in with your company account, and directory groups can give them roles. See Company sign-in.
- Directory connected. Shown only when your plan includes provisioning. Your directory adds and removes members. See Provisioning with SCIM.
After the checklist
A few settings are worth a look once the basics are in place:
- Choose the design system members start in: Default design system.
- Make the design language available in everyone's tools: Turn it on for everyone.
- Keep at least two admins, in case one leaves. The last admin can't remove themselves or lower their own role.
If something goes wrong
| What you see | What to do |
|---|---|
| The checklist doesn't appear | It shows only to admins signed in through the portal, and only while a required step is left. |
| A step stays undone after you did it | Reload the home page. "Tools connected" needs an access token or a Connect sign-in in your organisation. |
| You're signed in with the setup link | Connect company sign-in and add your first admins now: that session ends in two hours. |