> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userplane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Invite Policies

> Control how new members join your workspace — private, whitelisted, or protected

Your workspace's invite policy determines how new people can discover and join your workspace.

## Policy types

| Policy          | Discoverable | How people join                                                                                                                    |
| --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Private**     | No           | Only explicit invitations. The workspace does not appear in search or suggestions.                                                 |
| **Whitelisted** | Yes          | People with an email address matching a whitelisted domain can join directly. Others need an explicit invitation.                  |
| **Protected**   | Yes          | People with a matching email domain can **request access**. An owner must approve the request. Others need an explicit invitation. |

## Setting your invite policy

<Steps>
  <Step title="Open General settings">
    Go to [Workspace Settings > General](https://dash.userplane.io/_/settings?tab=workspace).

    <Frame caption="Invite policy settings">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-settings.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=845a0c102720cdfdbf0d30df1d9c4610" width="1920" height="958" data-path="media/workspace/invite-policy/invite-policy-settings.png" />
    </Frame>

    <Frame caption="Access policy">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/access-policy-expanded.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=b75196b71d38902b114d5eda8ed3cc35" width="1342" height="906" data-path="media/workspace/invite-policy/access-policy-expanded.png" />
    </Frame>
  </Step>

  <Step title="Select a policy">
    Choose a policy that matches how you want people to join your workspace.

    <Tabs>
      <Tab title="Private">
        Only explicit invitations. The workspace does not appear in search or suggestions.

        <Frame caption="Private invite policy">
          <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-private.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=ba6dc7cedd3bcbc03411791d8b0e4891" width="1920" height="958" data-path="media/workspace/invite-policy/invite-policy-private.png" />
        </Frame>
      </Tab>

      <Tab title="Whitelisted">
        People with an email address matching a whitelisted domain can join directly. Others need an explicit invitation.

        <Frame caption="Whitelisted invite policy">
          <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-whitelisted.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=28ce83d72b2ca7d403d9e0e08798d416" width="1920" height="957" data-path="media/workspace/invite-policy/invite-policy-whitelisted.png" />
        </Frame>
      </Tab>

      <Tab title="Protected">
        People with a matching email domain can **request access**. An owner must approve the request. Others need an explicit invitation.

        <Frame caption="Protected invite policy">
          <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-protected.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=e4fe310a41b06024487dbdce0c684467" width="1920" height="958" data-path="media/workspace/invite-policy/invite-policy-protected.png" />
        </Frame>

        <Frame caption="Request workspace access">
          <img src="https://mintcdn.com/userplane/8_FOZno9A0XwGdNH/media/intercom/workspace-settings/request-workspace-access.png?fit=max&auto=format&n=8_FOZno9A0XwGdNH&q=85&s=272a463c7fe5c581f5b2fc3b3e438860" width="2940" height="1664" data-path="media/intercom/workspace-settings/request-workspace-access.png" />
        </Frame>

        <Frame caption="Protected policy settings">
          <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/protected-policy.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=d53904835be9dad6f29a93b730ca2668" width="2580" height="1492" data-path="media/workspace/invite-policy/protected-policy.png" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Add email domains (optional)">
    If using **Whitelisted** or **Protected**, add email domains to control who can join. See [Email domains](#email-domains) below for details.
  </Step>
</Steps>

<Note>Only workspace **owners** can change the invite policy.</Note>

## Email domains

When using the **Whitelisted** or **Protected** policy, you configure a list of allowed email domains. Only people with email addresses matching one of these domains can auto-join (whitelisted) or request access (protected). Everyone else needs an explicit invitation.

### Managing domains

Add or remove domains at any time from the invite policy settings. Enter a domain (e.g. `acme.com`) and save — anyone with an `@acme.com` email address can then join or request access depending on your policy. Changes take effect immediately.

<Frame caption="Whitelist configuration">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-whitelist.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=67c18e34790ee5d09d771e9b0035b789" width="1920" height="958" data-path="media/workspace/invite-policy/invite-policy-whitelist.png" />
</Frame>

<Frame caption="Domain whitelist">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/domain-whitelist.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=c00a7c8c09678fe3f926bc997cc24e9a" width="2580" height="1492" data-path="media/workspace/invite-policy/domain-whitelist.png" />
</Frame>

<Frame caption="Updating allowed email domains">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invite-policy/invite-policy-update-allowed-emails.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=4ff7bb04b0bf2e52120fd7de121ceb2d" width="1920" height="957" data-path="media/workspace/invite-policy/invite-policy-update-allowed-emails.png" />
</Frame>

### Limits

You can whitelist up to **5 email domains** per workspace. If you need to support more domains, consider using the **Protected** policy so an owner can manually approve requests from any email address.

## Rotating the invite token

If you need to invalidate existing invitation links, you can rotate your workspace's invite token. This invalidates all pending invitations and generates a new token.

<Steps>
  <Step title="Open General settings">
    Go to [Workspace Settings > General](https://dash.userplane.io/_/settings?tab=workspace) and find the invite token section.

    <Frame caption="Rotate invite token">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invites/invite-token-reset.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=53e1754e319570a67dc4c561e1f996cd" width="1920" height="958" data-path="media/workspace/invites/invite-token-reset.png" />
    </Frame>
  </Step>

  <Step title="Rotate the token">
    Click **Rotate Token** and confirm. All pending invitations are invalidated immediately.

    <Frame caption="Token reset confirmation">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/invites/invite-token-reset-confirmation.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=6be0df60ce4c6c5ef14085a459405f8f" width="1920" height="959" data-path="media/workspace/invites/invite-token-reset-confirmation.png" />
    </Frame>
  </Step>
</Steps>

## Related articles

* [Team Management](/workspace/team-management) — invite and manage members.
* [Access Management](/workspace/access-management) — approve or decline access requests (protected policy).
* [Roles & Permissions](/workspace/roles-permissions) — what each role can do.
