> ## 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.

# Workspace Discoverability

> Make it easy for your coworkers to join

### 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.

If a join request is rejected, that user cannot request again through discoverability.
An admin can still grant access later through a direct invite.

Use discoverability when your goal is shared organizational onboarding.
Do not rely on it when you need strict prevention of extra workspace creation.

<Info>
  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.
</Info>

### 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**.

<Steps>
  <Step title="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](https://app.speckle.systems/settings/user/emails) (avatar menu -> User settings -> Emails). Any emails you verify there will show up as available domains you can connect to your workspace.
  </Step>

  <Step title="Enable workspace discoverability">
    Enable workspace discoverability with the toggle switch on the Security settings page.
  </Step>
</Steps>

### Joining without admin approval

<CardGroup cols={2}>
  <Card title="Require admin approval" icon="user-check">
    New users submit a join request. Admins review and approve in Team.
  </Card>

  <Card title="Allow immediate joining" icon="bolt">
    Users matching verified domains join immediately without admin action.
  </Card>
</CardGroup>

Use approval mode when membership control matters more than onboarding speed.
Use immediate joining only when your domain population is tightly controlled and billing risk is acceptable.

<Warning>
  Joining without admin approval should be used with caution. Suitable for
  **Enterprise** and **Academia** plans else you would be at risk of an
  uncontrolled escalation of your billing.
</Warning>

## 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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Who can approve discoverability join requests?">
    Workspace admins can approve or reject requests in
    **Team -> Join requests**.
  </Accordion>

  <Accordion title="Can we use discoverability with public email domains?">
    No. Domains like Gmail and Outlook are not treated as organization domains
    for discoverability.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>