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

Fix problems with Design Language Connect

What to do when Connect won't open, can't reach the portal, or can't connect a tool.

For members of an organisation2 min read

Find what you see below. When a row in Design Language Connect shows an error, it uses the tool's own message; Settings › General › Show the log has the details.

Installing and opening

Installing and opening
What you seeWhat to do
macOS says it can't check the appChoose Done, then in System Settings › Privacy & Security choose Open Anyway. You do this once; updates need no approval.
Windows says it protected your PCChoose More info, then Run anyway. You do this once.
Windows asks for Microsoft Edge WebView2Older PCs may not have it. Choose Yes to download it from Microsoft, install it, then open Connect again.
Ubuntu 22.04's store can't install the packageRun sudo apt install ./design-language-connect.deb in your Downloads folder.
No icon by the clock on UbuntuUbuntu shows it through its AppIndicator extension, on by default. Other GNOME desktops need the "AppIndicator and KStatusNotifierItem Support" extension. Without it, open the window from your apps.
The window stays blank on UbuntuStart it from a terminal with design-language-connect and send the messages it prints to your admin.

Connecting and updating

Connecting and updating
What you seeWhat to do
Can't reach the portalCheck Portal address in Settings › General and that the portal is up, then choose Try again. You can still disconnect tools; connecting and updating need the portal.
Needs Node.js 20 or laterChoose Get Node.js, install it, then choose Check for updates.
Needs the claude or codex commandInstall Claude Code or Codex, then choose Check for updates.
No supported tools on this computer yetInstall a supported tool, then choose Check for updates. A tool appears once it's installed.
The design language is already in Codex or Claude Code from another placeIt came from a team marketplace or another folder. Update it there, or remove it and connect it in Connect.

Signing in

Signing in
What you seeWhat to do
This code isn't valid any moreCodes last 10 minutes and work once. Choose Sign in in Connect again.
Your sign-in expired or was revoked on the portalChoose Sign in again. VS Code, Cursor and Antigravity rows then offer Update to refresh their sign-in.
Your browser can't reach the approval pageUse Paste a token: see Sign in to Connect.
The approval page says access tokens aren't in your planAsk your admin.

Still stuck

Send your admin what the row or alert says and the relevant lines from Show the log. If you can't use the app at all, the same engine runs in a terminal: see Use Connect from the terminal.