Skip to main content

Switching and creating workspaces

This page covers three things: the workspace switcher in the sidebar, creating a new workspace, and the recovery screen you land on if you belong to no workspace yet.

How do I switch workspaces?​

At the top of the left sidebar is a button showing the current workspace's icon and name, with a dropdown arrow.

  • Collapsed sidebar: just the workspace's icon, either its logo or two-letter initials if no logo is set.
  • Expanded sidebar: the icon, the workspace name, and a chevron arrow.

Clicking it opens a menu with a Switch workspace list of every workspace you belong to. Each row shows:

  • The workspace's logo or initials.
  • The workspace name.
  • Your role in that workspace (Owner, Admin, or Member), in small text.
  • A checkmark next to the workspace that is currently active.

Clicking any workspace switches to it immediately. The whole app reloads its data for that workspace context, so projects, agents, and settings all change.

If you are in an active support session (ACE staff temporarily assisting inside a workspace you do not belong to), that workspace appears too, labeled "(support)".

At the bottom, a New workspace button (a dashed-border icon with a plus sign) opens the create form described below.

Good to know

There is no combined "all workspaces" view. The app is always scoped to exactly one workspace at a time. The switcher remembers the last workspace you viewed. If that workspace is no longer valid, for example if you were removed from it, it falls back to the first workspace in your list.

How do I create a workspace?​

Start from New workspace in the switcher, or from the recovery screen below.

Form fields:

  • Name: free text, for example "Acme Corp". Required.
  • URL slug: shown as ace.app/[slug]. It is generated from the name as you type (lowercase, spaces replaced with hyphens), and you can edit it by hand. It must be 3 to 50 characters, using lowercase letters, numbers, and hyphens only.
  • Create workspace: submits the form. It stays disabled until the name and slug are valid, and shows a "Creating…" spinner while the request is in flight.
  • Cancel: closes the form without creating anything. This button is only present in the modal, not on the recovery screen.

Inline validation errors:

  • "This URL is already taken." means the slug is already used by another workspace.
  • A generic failure message appears if the request fails for another reason.

Once created, the new workspace becomes active and you land on its empty dashboard, which prompts you to create your first project.

No-workspace recovery screen​

If you are signed in but currently belong to zero workspaces, for example after being removed from your last one, every workspace-scoped page is replaced by a full-screen recovery screen instead of a 404. Personal pages like Account Settings still work normally.

The screen shows:

  • A headline, "You're not part of any workspace," with instructions to accept an invitation or create a new one.
  • A Pending invitations card (only if you have any). Each invitation lists the workspace name and who invited you, with an Accept button. Accepting makes that workspace active and takes you to the dashboard.
  • A Create a new workspace card with the same create form described above, embedded directly on the page.
  • Footer links: Account settings and Sign out.

Invitation emails link to a dedicated accept-invitation page, outside the normal app shell. It shows:

  • The inviting workspace's logo and name.
  • Who invited you, and the role you are being invited as (Member or Admin).
  • If the invite grants access to specific projects, a list of those projects and the permissions attached to each.
  • An Accept invitation button. It reads "Sign in to accept" if you are not logged in: clicking it sends you to log in first, then returns you here to finish.
  • A Decline button, which returns to the dashboard without accepting.

If the invite cannot be shown, you see one of these states instead:

  • "This invitation has expired."
  • "This invitation was cancelled."
  • "This invitation has already been accepted."
  • "You are already a member of this organization."
  • "Invalid invitation link." or "Invitation not found." for a broken or missing link.

Next steps​

On this page