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

{% hint style="success" icon="user-key" %}
Role requirement: Organization Owners
{% endhint %}

{% @arcade/embed flowId="X8tu1cK6Ept44ZJ4Ttzv" url="<https://app.arcade.software/share/X8tu1cK6Ept44ZJ4Ttzv>" %}

{% stepper %}
{% step %}
Go to Organization Settings. You can access it from the bottom-left sidebar menu.
{% endstep %}

{% step %}
Open the Settings tab.
{% endstep %}

{% step %}
Find the Auto-join toggle.
{% endstep %}

{% step %}
Turn the toggle On.
{% endstep %}

{% step %}
Select a workspace from the dropdown menu.&#x20;

*This is the workspace that new users with a matching email domain will automatically join.*
{% endstep %}

{% step %}
The setting is saved automatically once you select a workspace.
{% endstep %}
{% endstepper %}

{% 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>

{% stepper %}
{% step %}
Go to Organization Settings <i class="fa-arrow-right">:arrow-right:</i> Settings tab.
{% endstep %}

{% step %}
Open the workspace dropdown under the auto-join toggle.
{% endstep %}

{% step %}
Select a different workspace.
{% endstep %}
{% endstepper %}

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>

{% stepper %}
{% step %}
Go to Organization Settings <i class="fa-arrow-right">:arrow-right:</i> Settings tab.
{% endstep %}

{% step %}
Turn the auto-join toggle Off.
{% endstep %}
{% endstepper %}

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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/account-management/workspaces-and-organization/auto-join-for-users-with-your-domain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.