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

# Permission Matrix

> Compare Admin, Manager, Member, and Viewer across page visibility and allowed actions

Check visibility first, then actions. A page being visible does not mean its buttons are editable.

## Legend

| Icon                                                                                                   | Meaning     |
| ------------------------------------------------------------------------------------------------------ | ----------- |
| <Tooltip tip="Can view and perform create, edit, delete, assignment, or execution actions">✅</Tooltip> | Manage      |
| <Tooltip tip="Can see the page or data, but is read-only by default">👀</Tooltip>                      | View only   |
| <Tooltip tip="Not available by default, or no usable permission is granted">⬜</Tooltip>                | Unavailable |

<Tip>
  Read the visibility table first, then the action table. Entering a page does not automatically mean you can save changes there.
</Tip>

## Page Visibility

| Page / Entry                     | Admin                                                                              | Manager                                                                                                  | Member                                                                                                   | Viewer                                                                                                      | Notes                                                  |
| -------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Workspace Settings               | <Tooltip tip="Can view and update workspace settings">✅</Tooltip>                  | <Tooltip tip="Can view some workspace information but cannot save changes">👀</Tooltip>                  | <Tooltip tip="Can view some workspace information but cannot save changes">👀</Tooltip>                  | <Tooltip tip="Workspace settings are not available by default">⬜</Tooltip>                                  | Members may see some information, but cannot manage it |
| Analytics                        | <Tooltip tip="Has full access to workspace-level analytics">✅</Tooltip>            | <Tooltip tip="Workspace-level analytics are not available by default">⬜</Tooltip>                        | <Tooltip tip="Workspace-level analytics are not available by default">⬜</Tooltip>                        | <Tooltip tip="Workspace-level analytics are not available by default">⬜</Tooltip>                           | This page is for the workspace management view         |
| Overview                         | <Tooltip tip="Can view and manage all farms">✅</Tooltip>                           | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>             | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>             | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>                | Non-admin visibility depends on farm assignment        |
| Farms List                       | <Tooltip tip="Can view and manage all farms">✅</Tooltip>                           | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>             | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>             | <Tooltip tip="Can view assigned farms or all farms if broader scope is granted">👀</Tooltip>                | Non-admin visibility depends on farm assignment        |
| Farm Details and operation pages | <Tooltip tip="Can view farm data, tasks, diagnosis, energy, and racks">✅</Tooltip> | <Tooltip tip="Can view farm data, tasks, diagnosis, energy, and racks inside assigned scope">✅</Tooltip> | <Tooltip tip="Can view farm data, tasks, diagnosis, energy, and racks inside assigned scope">✅</Tooltip> | <Tooltip tip="Can review farm data, tasks, diagnosis, energy, and racks inside assigned scope">👀</Tooltip> | Non-admin visibility depends on farm assignment        |
| Farm Settings                    | <Tooltip tip="Can view and update farm configuration">✅</Tooltip>                  | <Tooltip tip="Can update farm configuration inside assigned scope">✅</Tooltip>                           | <Tooltip tip="Can usually view farm configuration but cannot save changes">👀</Tooltip>                  | <Tooltip tip="Can usually view farm configuration but cannot save changes">👀</Tooltip>                     | Manager edit access follows farm assignment            |
| Miners                           | <Tooltip tip="Can view and manage all miners">✅</Tooltip>                          | <Tooltip tip="Can view and manage miners inside assigned scope, including high-risk actions">✅</Tooltip> | <Tooltip tip="Can view and operate miners inside assigned scope">✅</Tooltip>                             | <Tooltip tip="Can only view miner status and data">👀</Tooltip>                                             | Non-admin actions depend on farm assignment            |

## Action Permissions

| Action                                             | Admin                                                                            | Manager                                                                                     | Member                                                                                      | Viewer                                                                                  | Notes                                                    |
| -------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| View member information                            | <Tooltip tip="Can view and manage all member information">✅</Tooltip>            | <Tooltip tip="Can view member information in read-only mode">👀</Tooltip>                   | <Tooltip tip="Can view member information in read-only mode">👀</Tooltip>                   | <Tooltip tip="Member information is not available by default">⬜</Tooltip>               | Members can view but not manage people                   |
| View invitations                                   | <Tooltip tip="Can view and manage invitation records">✅</Tooltip>                | <Tooltip tip="Invitation records are not available">⬜</Tooltip>                             | <Tooltip tip="Invitation records are not available">⬜</Tooltip>                             | <Tooltip tip="Invitation records are not available">⬜</Tooltip>                         | Invitation management is reserved for Admin              |
| Invite members / revoke invitations                | <Tooltip tip="Can send and revoke invitations">✅</Tooltip>                       | <Tooltip tip="Cannot invite members or revoke invitations">⬜</Tooltip>                      | <Tooltip tip="Cannot invite members or revoke invitations">⬜</Tooltip>                      | <Tooltip tip="Cannot invite members or revoke invitations">⬜</Tooltip>                  | This is a team governance action                         |
| Change roles / remove members                      | <Tooltip tip="Can change roles and remove members">✅</Tooltip>                   | <Tooltip tip="Cannot change roles or remove members">⬜</Tooltip>                            | <Tooltip tip="Cannot change roles or remove members">⬜</Tooltip>                            | <Tooltip tip="Cannot change roles or remove members">⬜</Tooltip>                        | Only Admin can change access boundaries                  |
| Manage member farm scope                           | <Tooltip tip="Can assign and update member farm scope">✅</Tooltip>               | <Tooltip tip="Cannot assign farm scope">⬜</Tooltip>                                         | <Tooltip tip="Cannot assign farm scope">⬜</Tooltip>                                         | <Tooltip tip="Cannot assign farm scope">⬜</Tooltip>                                     | Only Admin controls resource coverage                    |
| View workspace settings                            | <Tooltip tip="Can view and manage workspace settings">✅</Tooltip>                | <Tooltip tip="Can view some workspace settings in read-only mode">👀</Tooltip>              | <Tooltip tip="Can view some workspace settings in read-only mode">👀</Tooltip>              | <Tooltip tip="Workspace settings are not available by default">⬜</Tooltip>              | Member visibility does not imply edit rights             |
| View notification and alert settings               | <Tooltip tip="Can view and manage notification and alert settings">✅</Tooltip>   | <Tooltip tip="Can view notification and alert settings">👀</Tooltip>                        | <Tooltip tip="Can view notification and alert settings">👀</Tooltip>                        | <Tooltip tip="Notification and alert settings are not available by default">⬜</Tooltip> | This is read-only for non-admin roles                    |
| Manage notification and alert settings             | <Tooltip tip="Can create and update notification and alert settings">✅</Tooltip> | <Tooltip tip="Cannot save notification or alert changes">⬜</Tooltip>                        | <Tooltip tip="Cannot save notification or alert changes">⬜</Tooltip>                        | <Tooltip tip="Cannot save notification or alert changes">⬜</Tooltip>                    | Notification management belongs to Admin                 |
| Create / revoke API Key                            | <Tooltip tip="Can create, revoke, or rotate API Key">✅</Tooltip>                 | <Tooltip tip="Cannot create or revoke API Key">⬜</Tooltip>                                  | <Tooltip tip="Cannot create or revoke API Key">⬜</Tooltip>                                  | <Tooltip tip="Cannot create or revoke API Key">⬜</Tooltip>                              | API Key management belongs to Admin                      |
| View farm list and details                         | <Tooltip tip="Can view and manage all farms">✅</Tooltip>                         | <Tooltip tip="Can view farms inside assigned scope">👀</Tooltip>                            | <Tooltip tip="Can view farms inside assigned scope">👀</Tooltip>                            | <Tooltip tip="Can view farms inside assigned scope">👀</Tooltip>                        | Non-admin roles can only see authorized farms            |
| Create / delete / archive / unarchive farms        | <Tooltip tip="Can manage the farm lifecycle">✅</Tooltip>                         | <Tooltip tip="Cannot create, delete, archive, or unarchive farms">⬜</Tooltip>               | <Tooltip tip="Cannot create, delete, archive, or unarchive farms">⬜</Tooltip>               | <Tooltip tip="Cannot create, delete, archive, or unarchive farms">⬜</Tooltip>           | Farm lifecycle management belongs to Admin               |
| Edit farm configuration                            | <Tooltip tip="Can manage farm configuration">✅</Tooltip>                         | <Tooltip tip="Can manage farm configuration inside assigned scope">✅</Tooltip>              | <Tooltip tip="Cannot save farm configuration changes">⬜</Tooltip>                           | <Tooltip tip="Cannot save farm configuration changes">⬜</Tooltip>                       | Farm configuration is separate from farm lifecycle       |
| View miner list, details, history, logs, and racks | <Tooltip tip="Can view and manage all miner data and history">✅</Tooltip>        | <Tooltip tip="Can view miner data and history inside assigned scope">👀</Tooltip>           | <Tooltip tip="Can view miner data and history inside assigned scope">👀</Tooltip>           | <Tooltip tip="Can view miner data and history inside assigned scope">👀</Tooltip>       | Scope is controlled by farm assignment                   |
| Export miner list                                  | <Tooltip tip="Can export miner lists">✅</Tooltip>                                | <Tooltip tip="Can export miner lists inside assigned scope">✅</Tooltip>                     | <Tooltip tip="Can export miner lists inside assigned scope">✅</Tooltip>                     | <Tooltip tip="Can export miner lists inside assigned scope">✅</Tooltip>                 | Export follows miner visibility                          |
| Import miners                                      | <Tooltip tip="Can import miners">✅</Tooltip>                                     | <Tooltip tip="Can import miners inside assigned scope">✅</Tooltip>                          | <Tooltip tip="Can import miners inside assigned scope">✅</Tooltip>                          | <Tooltip tip="Cannot import miners">⬜</Tooltip>                                         | Import is an operator action                             |
| Run routine miner operations and tasks             | <Tooltip tip="Can run routine miner operations and tasks">✅</Tooltip>            | <Tooltip tip="Can run routine miner operations and tasks inside assigned scope">✅</Tooltip> | <Tooltip tip="Can run routine miner operations and tasks inside assigned scope">✅</Tooltip> | <Tooltip tip="Cannot run miner operations or create tasks">⬜</Tooltip>                  | Member execution stays within farm scope                 |
| Farm-managed miner operations                      | <Tooltip tip="Can run farm-managed miner operations">✅</Tooltip>                 | <Tooltip tip="Can run farm-managed miner operations inside assigned scope">✅</Tooltip>      | <Tooltip tip="Cannot run farm-managed miner operations">⬜</Tooltip>                         | <Tooltip tip="Cannot run farm-managed miner operations">⬜</Tooltip>                     | These actions are managed with farm configuration access |
| High-risk miner actions (delete, archive)          | <Tooltip tip="Can run all high-risk miner actions">✅</Tooltip>                   | <Tooltip tip="Can run high-risk miner actions inside assigned scope">✅</Tooltip>            | <Tooltip tip="Cannot run high-risk miner actions">⬜</Tooltip>                               | <Tooltip tip="Cannot run high-risk miner actions">⬜</Tooltip>                           | The key distinction between Manager and Member           |
| Unrestricted cross-farm access                     | <Tooltip tip="Has access to all farms and miners by default">✅</Tooltip>         | <Tooltip tip="Does not receive all-farm access by default">⬜</Tooltip>                      | <Tooltip tip="Does not receive all-farm access by default">⬜</Tooltip>                      | <Tooltip tip="Does not receive all-farm access by default">⬜</Tooltip>                  | Non-admin roles follow least-privilege by default        |

## How To Use This Matrix

* Choose **Admin** if someone needs to manage members, invitations, or API Key access
* Choose **Manager** if someone needs to manage assigned farm configuration, firmware or pool operations, and high-risk miner actions
* Choose **Member** if someone needs to run routine miner operations and tasks but should not manage farm configuration or the team
* Choose **Viewer** if someone only needs to monitor status, reports, and results

<Info>
  If someone "should be able to operate but can only view," the problem is usually the wrong role or the wrong farm scope.
</Info>