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 and share responsibilities. (Messaging/inquiries are planned and may not be available in all builds yet.)
What types of organizations are supported?
| Type | Description | Free listings (planned)? |
|---|
shelter | Animal rescue, humane society, foster network | Yes |
farm | Working farm selling livestock | No |
breeder | Professional breeding operation | No |
How do I create an organization?
- Go to Profile → Organizations
- Tap “Create Organization”
- Enter the organization name and select the type
- 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?
- Go to Profile → Organizations → Select your org
- Tap “Invite Member”
- Enter their email address and select a role (Manager or Staff)
- They’ll receive an email invitation to join
- 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.
Last modified on February 11, 2026