---
title: "Organizations"
description: "One workspace per org. Switch orgs from the top-left. Role hierarchy and ownership."
---

An **organization** (org) in simple-plm is a tenant: one `plm-data/` Git repo, one isolated tenant pod, one billing account. You can belong to many orgs with one Google identity.

## Switching orgs

The top-left of the dashboard shows the active org. Click it to open the org switcher. Picking a different org reloads the dashboard against that org's data. The org you most recently used becomes the default on your next sign-in.

## Roles

| Role | Can sign in | Read | Write | Review ECOs | Merge | Manage members | Manage billing |
|------|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
| `owner`    | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| `admin`    | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| `reviewer` | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| `member`   | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |

Every org has at least one `owner`; the first user (org creator) is owner by default. Owners can promote and demote freely, with the constraint that the last owner can't demote themselves without first promoting someone else.

## Creating an org

If you're signing up fresh (no invitation), the signup flow creates an org for you using your email's domain as the default name. You can rename it from Settings → Organization at any time.

## Deleting an org

Owners can delete an org from Settings → Organization → **Danger zone**. Deletion:

1. Cuts a final release bundle so the snapshot is downloadable.
2. Tombstones the org for 30 days (recoverable by support during that window).
3. Permanently removes the tenant pod, Git repo, and database on day 31.

There is no soft-delete for individual parts or BOMs — those live as commits in the repo and follow Git's history. Use `git revert` or an ECO if you need to undo something.
