# Org Permissions Matrix

Organization settings defining what each role can do on projects, members and billing.

- id: `org-permissions-matrix`
- Page: https://agentic-ui-kit.com/components/org-permissions-matrix
- Live preview: https://agentic-ui-kit.com/live/component/org-permissions-matrix

## Install

```bash
agentic-ui add org-permissions-matrix
npx shadcn@4.17.0 add @agentic-ui/org-permissions-matrix
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** roles-by-resources-grid, tri-state-rollup, bulk-toggle, locked-role, read-only-mode, live-announcements, density-switch, empty-state, error-recovery, keyboard-navigation
- **Intents:** configure, manage-collection, track-status, audit-trail
- **Suits domains:** auth, settings, saas, operations, project-management
- **Interaction:** toggle-permission, bulk-toggle, density-switch, keyboard-navigation, error-recovery
- **Screen role:** management
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** organization settings defining what each role can do on projects, members and billing, multi-tenant console with custom roles and granular per-resource permissions, read-only audit view of effective permissions before approving an access change, RBAC editor where the owner role is locked and the rest is editable
- **Avoid when:** only a flat role is assigned per user with no granular permissions (use a role picker), a member directory with activity and teams is needed rather than a permissions matrix (use project-management-org-members-directory), the number of resources and actions makes the grid unreadable and a per-resource editor with search is better
- **Preserve when adapting:** roles-as-rows-resources-as-columns, tri-state-rollup-semantics, accessible-cell-naming, live-region-feedback, locked-role-contract
- **Replace when adapting:** domain-copy, role-catalog, resource-and-action-catalog, persistence-adapter
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button, checkbox, switch
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives