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

# Organizations

> Organization model, roles, and multi-org access

# Organizations

Every user belongs to one or more Organizations. An organization is the top-level container for all data in agronome.ai — farms, fields, drone jobs, integrations, and team members.

## Organization types

The organization type determines the platform persona and UI experience:

| Type         | Persona    | Use case                                              |
| ------------ | ---------- | ----------------------------------------------------- |
| `farm`       | Grower     | Individual farming operation                          |
| `consulting` | Consultant | Agricultural consulting firm serving multiple clients |
| `processor`  | Processor  | Supply chain operator with contracted farms           |

## Roles

Each membership (user + organization) has a role that controls what actions are permitted:

| Role       | View data | Edit fields/farms | Manage members | Billing & settings |
| ---------- | :-------: | :---------------: | :------------: | :----------------: |
| **Viewer** |    Yes    |         —         |        —       |          —         |
| **Editor** |    Yes    |        Yes        |        —       |          —         |
| **Admin**  |    Yes    |        Yes        |       Yes      |          —         |
| **Owner**  |    Yes    |        Yes        |       Yes      |         Yes        |

* Every organization has exactly one **Owner** (the creator)
* **Admins** can invite new members and change roles (except Owner)
* **Editors** can create and modify farms, fields, crop zones, and upload data
* **Viewers** have read-only access to all organization data

## Multi-org access

A single user can belong to multiple organizations. Common patterns:

* A **grower** owns their farm org and is a **viewer** in their processor's org
* A **consultant** owns their consulting org and is an **editor** in each client's farm org
* An **admin** manages day-to-day operations while the **owner** handles billing

Use the organization switcher in the sidebar to move between contexts. All data is isolated per organization — there is no cross-org data leakage.

## Inviting members

Admins and Owners can invite new members:

1. Go to **Settings → Team**
2. Click **Invite Member**
3. Enter their email and select a role
4. They receive an email invitation with a link to accept

Invitations expire after 7 days. Pending invitations can be revoked from the Team settings page.
