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

# Permission Groups

> Define roles and control access levels across your organization

Permission Groups allow you to define roles with specific access levels for organization management and project access. Assign members to groups to control what they can see and do.

## Default Permission Groups

Boltz provides four default permission groups that cover common organizational roles:

| Group           | Admin Access                             | Project Access         | Typical Use                            |
| --------------- | ---------------------------------------- | ---------------------- | -------------------------------------- |
| **Admin**       | Manage Members, Permissions, and Billing | Own                    | Organization administrators and owners |
| **All Members** | None                                     | Write                  | Standard team members                  |
| **Scientist**   | None                                     | Own (Write and Delete) | Project Leads and Designers            |
| **Viewer**      | None                                     | Read                   | External collaborators, stakeholders   |

***

## Editing Permissions

### Understanding Permission Levels

### Admin Access

Controls access to organization-level settings and management features.

| Level                                        | Description                                                                           |
| -------------------------------------------- | ------------------------------------------------------------------------------------- |
| **No access**                                | Cannot access any organization management features                                    |
| **Manage Members**                           | Can invite and remove members, assign permission groups                               |
| **Manage Members, Permissions, and Billing** | Full organization administration including billing and permission group configuration |

### Project Access

Controls what members can do within Design Projects.

| Level                      | Description                                                                        |
| -------------------------- | ---------------------------------------------------------------------------------- |
| **Read**                   | View projects, experiments, and results. Cannot create or modify.                  |
| **Write**                  | Create experiments, run virtual screens, triage molecules. Cannot delete projects. |
| **Own (write and delete)** | Full project control including creation and deletion.                              |

***

## Configuring Permission Groups

### Viewing Group Members

Click the **Members** button next to any group to see which users are assigned to it.

Click the **Permissions** button to modify a group's access levels:

1. **Organization management** - Select the admin access level
2. **Project access** - Select the project access level
3. Click **Save** to apply changes

<Warning>
  Be careful when modifying or assigning the group permissions so that users only have access to appropriate content
</Warning>

***

## Permission Group Assignments

Members can belong to multiple permission groups. When a member belongs to multiple groups, they receive the **highest** permission level from any of their groups.

**Example:** A user in both "All Members" (Write) and "Scientist" (Own) groups will have **Own** access to projects.

### Common Configurations

<AccordionGroup>
  <Accordion title="Academic Research Team Setup">
    * **Principal Investigators** → Admin + Scientist groups
    * **Postdocs/Senior Scientists** → Scientist group
    * **Graduate Students** → All Members group
    * **External Collaborators** → Viewer group
  </Accordion>

  <Accordion title="Biotech Company Setup">
    * **Department Heads** → Admin group
    * **Computational Chemists** → Scientist group
    * **Medicinal Chemists** → All Members group
    * **Management/Stakeholders** → Viewer group
  </Accordion>

  <Accordion title="CRO/Service Provider Setup">
    * **Account Managers** → Admin group
    * **Project Scientists** → Scientist group
    * **Clients (read-only access)** → Viewer group
  </Accordion>
</AccordionGroup>

***

## Creating Custom Permission Groups

<Note>
  Custom permission group creation may be available.

  Contact support for details.
</Note>

***

## Best Practices

<Tip>
  **Principle of least privilege**: Assign the minimum permissions necessary for each role. Start with restrictive access and expand as needed.
</Tip>

<Tip>
  **Use All Members as a baseline**: Keep all users in the "All Members" group for basic platform access, then add specialized groups for elevated permissions.
</Tip>

<Tip>
  **Document your permission structure**: For larger organizations, maintain documentation of which roles map to which permission groups.
</Tip>

***