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

# Members & Groups

> Manage project team access and create permission groups.

Members & Groups controls who can access your project and what actions they can perform. Access from Settings → Members & Groups within a project.

## Members

The Members tab shows everyone with access to the project.

### Member information

| Column  | Description                                          |
| ------- | ---------------------------------------------------- |
| User    | Member's email with role badge (Admin if applicable) |
| Groups  | Permission groups the member belongs to              |
| Actions | Edit membership or remove from project               |

### Inviting members

Add organization users to your project:

1. Click "Invite member"
2. Select users from the dropdown
3. Optionally assign to one or more groups
4. Check "Admin" to grant full project access
5. Click Invite

If a user isn't listed, they need to be added to the organization first. Click the "Users" link in the modal to navigate to organization user management.

### Project admins

Members with the Admin flag have full access to the project, including:

* All permissions regardless of group membership
* Ability to manage other members and groups
* Access to all project settings

### Removing members

Click the remove action next to any member to revoke their project access. This doesn't affect their organization membership.

## Groups

Groups bundle permissions together for easier management. Assign members to groups instead of managing individual permissions.

### Creating a group

1. Go to the Groups tab
2. Click "Create"
3. Enter name and description
4. Select permissions from the tree
5. Configure file permissions (optional)
6. Click Create

### Group properties

| Property         | Description             |
| ---------------- | ----------------------- |
| Name             | Group identifier        |
| Description      | Purpose of the group    |
| Permissions      | Selected capabilities   |
| File Permissions | Path-based access rules |

### Permission categories

Select permissions from these categories:

| Category       | Available permissions                             |
| -------------- | ------------------------------------------------- |
| Project Manage | Members, groups, tokens, approvers, configuration |
| Documents (v1) | Full, Edit Content, View Content, Edit View       |
| Branches (v2)  | Create, Merge, Delete                             |
| Releases       | Manage, Deploy, Delete                            |
| Environments   | Manage, Delete                                    |

### File permissions

Add granular access rules for specific files or folders.

**Configuration:**

| Field    | Options                                        |
| -------- | ---------------------------------------------- |
| Effect   | Allow or Deny                                  |
| Patterns | Glob patterns matching files                   |
| Actions  | Visible, Modify, Write (create/update), Delete |

**Pattern examples:**

| Pattern     | Matches                            |
| ----------- | ---------------------------------- |
| `**`        | All files in the project           |
| `folder/*`  | Files directly in folder           |
| `folder/**` | All files in folder and subfolders |
| `pricing/*` | All files in the pricing folder    |
| `*.json`    | All JSON files                     |

**Rule evaluation:**

When multiple rules match a file, Deny rules take precedence over Allow rules. Use this to grant broad access with specific restrictions.

### Editing groups

Click the edit action on any group to modify its permissions or file access rules.

### Deleting groups

Remove a group to revoke its permissions from all members. Members remain in the project but lose the group's permissions unless granted through another group.
