Documentation Index
Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
Use this file to discover all available pages before exploring further.
What is workspace discoverability?
Workspace discoverability helps people in your organization find and join the correct workspace. It reduces duplicate workspace creation and lowers manual onboarding effort. Users can open this flow from the top-left workspace menu under Join existing workspaces. The dialog lists workspaces that match the user’s email domain. When enabled, users signing up with your verified domains are prompted to join your workspace. By default, they submit a request to join, which emails workspace admins. Admins then approve or reject requests in Team -> Join requests. In Team, this appears under the Join requests tab next to Members, Guests, and Pending invites. Users may see these statuses in the join dialog:- Joined: the user is already a member of that workspace.
- Request pending: a join request was sent and is waiting for admin action.
Workspace discoverability doesn’t prevent your coworkers from creating other
workspaces. It only encourages joining the same one. Completely preventing
other workspaces from being created is an Enterprise feature.
Make a workspace discoverable
Only workspace admins can change discoverability controls. Members can view the setting but cannot modify it. Configure this in Settings -> Security, under Discoverable workspace.Connect verified domains to workspace
Workspace discoverability works by linking one or more verified domains to the workspace. You can verify a domain from the top of the Security settings page.If you signed up using a company domain, that domain is usually already verified and can be linked in one click. Public email providers (for example Gmail or Outlook) are not treated as organization domains for this flow.To connect additional domains to your workspace, first verify more emails in your email settings (avatar menu -> User settings -> Emails). Any emails you verify there will show up as available domains you can connect to your workspace.
Joining without admin approval
Require admin approval
New users submit a join request. Admins review and approve in Team.
Allow immediate joining
Users matching verified domains join immediately without admin action.
If users cannot find or join your workspace
Check these items in order:- Confirm discoverability is enabled in Settings -> Security.
- Confirm the user’s email domain is linked as a verified workspace domain.
- Confirm the user is trying from Join existing workspaces.
- If request status is Request pending, approve in Team -> Join requests.
- If a request was rejected earlier, send a direct invite from Team.
FAQ
How do we stop people in our organization from creating their own workspaces?
How do we stop people in our organization from creating their own workspaces?
First confirm this is what you want. Some organizations intentionally keep
separate workspaces by region or business unit (for example, ACME EU and
ACME US).
If you need strict prevention, Enterprise plans support exclusivity controls
based on verified email domains.
Does discoverability force people into our workspace?
Does discoverability force people into our workspace?
No. Discoverability prompts matching users to join. It does not force
membership or block them from creating a different workspace.
Who can approve discoverability join requests?
Who can approve discoverability join requests?
Workspace admins can approve or reject requests in
Team -> Join requests.
Can we use discoverability with public email domains?
Can we use discoverability with public email domains?
No. Domains like Gmail and Outlook are not treated as organization domains
for discoverability.
What should we use if discoverability is too open for our policy?
What should we use if discoverability is too open for our policy?
Use approval mode, and combine it with domain protection and SSO settings
where needed.