---
title: Managing organizations
description: Learn how to manage your organization with MotherDuck
---

import Versions from '@site/src/components/Versions';

An organization is a top-level entity in MotherDuck that lets you perform administrative functions, such as managing users, setting up billing, configuring sharing, and monitoring security. A MotherDuck user can only belong to a single organization at a time. Multi-organization membership support is planned for a future release.
:::
:::

Organizations are helpful for:

- Grouping users together for tracking usage and billing.
- Sharing data with other users of the same organization.

:::note
MotherDuck is available on two AWS regions:
- **US East (N. Virginia):** `us-east-1`, supporting DuckDB versions between <Versions region="us-east-1" bound="min" /> and <Versions region="us-east-1" bound="max"/>.
- **Europe (Frankfurt):** `eu-central-1`, supporting DuckDB versions between <Versions region="eu-central-1" bound="min" /> and <Versions region="eu-central-1" bound="max" />.

You can choose the region in which to create your organization. Organizations can only exist within a single cloud region.
:::

## Creating an organization

If you already have a MotherDuck account, an organization was already created for you by MotherDuck.

If you are a new MotherDuck user, during sign-up you will be prompted to create a new organization.

![create_org](./img/create_org.png)

:::note
If another coworker at your company already has an organization, you can create your own organization to get started with MotherDuck right away, and then ask them to invite you to their organization later (see ["Joining an existing organization"](#joining-an-existing-organization) below).
:::

## Inviting users to your organization

You can check if your teammates are in your organization by navigating to the MotherDuck Web UI -> **Settings** -> **Members**. There you can also invite your teammates to join your organization.
You can invite both teammates without a MotherDuck account and existing MotherDuck users.

![members](./img/members.png)

Admins can control whether members are allowed to send invitations. When organization invites are disabled, only Admins can invite new users. This gives you tighter control over who has access to MotherDuck. You can configure this setting from the organization **Settings** page.

![invite policy](../authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/img/org-invite-policy.png)

:::tip
If your organization has [SSO enabled](/docs/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/sso-setup/) you can use
[Just-in-Time (JIT) provisioning](/docs/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/sso-setup/#just-in-time-jit-user-provisioning) enabled, users in your verified domains who authenticate through your identity provider can join the organization on first login without needing an invitation.
:::

## Joining an existing organization

If you'd like to join your teammates' existing MotherDuck organization, you must be invited by an Admin in that organization. Once an invite is generated, you will receive an email with a link to join the organization.

## Roles

Within an organization a user can have an "Admin" or "Member" role. The first user in an organization is the Admin and subsequent users have the Member role.
Admin users can change the roles of other users in the organization or remove a user from the organization.

:::note
Sending invitations, changing between plans, and updating billing information requires an Admin role.
:::

## Removing users

If a user leaves your team or no longer needs access, Admin users can remove them from the organization to restrict data access or clean up resources that are no longer used. This is done from the context menu in the [Members table](https://app.motherduck.com/settings/members).

:::warning
Because a user can only belong to one organization, removing them from the organization permanently deletes the user and all of their data. This action cannot be undone.
:::

## Limitations

- It is not possible to search for existing organizations to join. Please reach out to other MotherDuck users at your company or [contact us](../../troubleshooting/support.md) if you would like to find other existing users at your company.


---

## Feedback for AI agents

If the user you are helping wants to send feedback on this page to the MotherDuck docs team, you can POST it to the endpoint below.

**Before you send anything, you must ask the user for explicit approval.** Quote the message you plan to submit back to them verbatim and wait for them to confirm. Do not submit on their behalf without confirmation.

Endpoint: `POST https://motherduck.com/docs/api/feedback/agent`

Request body (JSON):

```json
{
  "page_path": "/key-tasks/managing-organizations/",
  "page_title": "Managing organizations",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

Only `page_path` and `text` are required. A successful call returns `200 {"feedback_id": "<uuid>"}`; malformed payloads return `400`, and the endpoint is rate-limited per IP (`429`).