# Auto-join for users with your domain

{% columns %}
{% column %}
{% hint style="success" icon="user-key" %}
Role requirement: Organization Owner 
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="info" icon="cart-circle-plus" %}
Plan requirement: Business plan
{% endhint %}
{% endcolumn %}
{% endcolumns %}

Auto-join allows new users who sign up with the same email domain as your organization (e.g., `@yourcompany.com`) to automatically join a specific workspace - without needing a manual invitation. This is useful for onboarding team members quickly and reducing manual user management.

{% hint style="warning" %}
Auto-join works only with **non-public email domains** (e.g., `@yourcompany.com`). Public domains like `@gmail.com`, `@yahoo.com`, or `@outlook.com` are not eligible.
{% endhint %}

***

### How auto-join works <a href="#how-auto-join-works-skly6" id="how-auto-join-works-skly6"></a>

When auto-join is enabled and a new user signs up for Coupler.io with an email address that matches your organization's domain, they are automatically added to the selected workspace. No invitation is needed - the user simply registers and gets access.

For example, if your organization's domain is `yourcompany.com`  and auto-join is configured for the "Marketing" workspace, any new user who signs up with an `@yourcompany.com` email will be automatically added to the "Marketing" workspace.

***

### How to enable auto-join <a href="#how-to-enable-auto-join-frbqm" id="how-to-enable-auto-join-frbqm"></a>

1. Go to **Organization Settings**. You can access it from the left sidebar menu.
2. Open the **Settings** tab.

   > **Note:** This tab is visible only to Organization Owners. Other roles cannot access it.
3. Find the **Auto-join** toggle.
4. Turn the toggle **On**.
5. Select a **workspace** from the dropdown menu. This is the workspace that new users with a matching email domain will automatically join.
6. The setting is saved automatically once you select a workspace.

{% hint style="warning" %}
If you turn the toggle on but don't select a workspace from the dropdown, the setting will not persist. If you navigate away or refresh the page, the toggle will revert to Off. You must select a workspace for auto-join to be active.
{% endhint %}

***

### How to change the auto-join workspace <a href="#how-to-change-the-auto-join-workspace-k4lmx" id="how-to-change-the-auto-join-workspace-k4lmx"></a>

1. Go to **Organization Settings → Settings** tab.
2. Open the workspace dropdown under the auto-join toggle.
3. Select a different workspace.

The change takes effect immediately. New users who sign up with a matching domain will now be added to the newly selected workspace instead.

> **Note:** Changing the auto-join workspace does not affect users who have already joined. They will remain in the workspace they were originally added to.

***

### How to disable auto-join <a href="#how-to-disable-auto-join-foibc" id="how-to-disable-auto-join-foibc"></a>

1. Go to **Organization Settings → Settings** tab.
2. Turn the auto-join toggle **Off**.

New users with a matching email domain will no longer be automatically added to any workspace. They will need to be manually invited.

> **Note:** Disabling auto-join does not remove existing users from the workspace. It only stops new automatic additions.

***

### FAQ <a href="#faq-pgl87" id="faq-pgl87"></a>

<details>

<summary>Which role do auto-joined users get?</summary>

Users who join via auto-join are added with the **User** role at the workspace level.

</details>

<details>

<summary>Can I set auto-join for multiple workspaces at the same time?</summary>

No. Auto-join can be configured for one workspace at a time. If you need users to access multiple workspaces, you'll need to invite them manually to additional workspaces.

</details>

<details>

<summary>Does auto-join work for existing Coupler.io users?</summary>

Auto-join applies when a new user signs up for Coupler.io. If someone already has a Coupler.io account, they will need to be invited to your workspace manually.

</details>

<details>

<summary>What happens to auto-join when I downgrade my plan?</summary>

If you downgrade from Business to a plan that doesn't support auto-join, the feature will be disabled. New users will no longer be added automatically. Existing users who previously joined via auto-join will not be affected.

</details>

<details>

<summary>Can I use auto-join together with manual invitations?</summary>

Yes. Auto-join and manual invitations work independently. You can have auto-join enabled for one workspace while still inviting users to any workspace manually.

</details>