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

# Organizations

> Create and manage organizations for shelters, farms, and breeders

# Organizations

## What is an organization?

An organization is a group account for shelters, farms, or professional breeders. It allows multiple team members to manage listings, share a pickup location, and sell under one org profile. Buyers can message organization listings the same way they message individual sellers.

## What types of organizations are supported?

| Type      | Description                                   | Free listings?                              |
| --------- | --------------------------------------------- | ------------------------------------------- |
| `shelter` | Animal rescue, humane society, foster network | Yes (nonprofit / shelter free-listing orgs) |
| `farm`    | Working farm selling livestock                | No                                          |
| `breeder` | Professional breeding operation               | No                                          |

Free listing eligibility for shelters is configured by the platform. For how free activations work at checkout, see [Listing fees, Extend, and Renew](/help/listing-fees-and-activation).

## How do I create an organization?

1. Open **Profile**.
2. Open the **Selling** tab.
3. In **Organizations**, tap **Create Organization**.
4. Enter the organization name and select the type.
5. You become the organization **Admin** automatically (creator role).

If you choose **Nonprofit (shelter)**, you'll be prompted to optionally upload documentation (PDF) for verification.

## Organization roles

| Role        | Permissions                                                                                                                |
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Admin**   | Creator role (in Clerk). Full control: invite/remove members, manage org settings, and perform high-privilege org actions. |
| **Manager** | Can manage members and listings (invitable role). Intended for org leaders/directors.                                      |
| **Staff**   | Can assist with listings and inventory (invitable role). Cannot manage members or org-level settings.                      |

## How do I invite someone to my organization?

1. Open **Profile** → **Selling** → **Organizations** and select your org.
2. Tap **Invite Member**.
3. Enter their email address and select a role (**Manager** or **Staff**).
4. They'll receive an email invitation to join.
5. **Important**: The invitee must not already belong to another organization (single-org model).

## Can someone be in multiple organizations?

No. The app enforces a **single-organization-per-user** model:

* The database has a unique constraint on `organization_members.user_id`.
* The Clerk webhook handler actively blocks/undoes accidental multi-org memberships.

## Why can't I join a second organization?

Because of the single-org model, accepting an invitation while you're already in an organization will be blocked (and may be auto-reverted by the webhook). Leave your current organization first, then accept the new invite.

## How do I change organizations?

Leave your current organization first, then accept an invitation or create a new organization.

## What happens when I leave an organization?

* If you are **Staff/Manager**, leaving removes your membership.
* If you are the **Admin** and there are other members, you must transfer admin responsibility (or remove other members) before leaving.
* If you are the **Admin** and the **only member**, leaving deletes the organization.

## What happens when I delete an organization?

* If you're the **only member** and you leave, the organization is deleted in Clerk (and will cascade-delete related rows in Supabase).
* If there are multiple members, leaving removes only your membership (org remains).
* Deletion is not reversible.