> ## 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.

# Project Settings

> Configure general project settings including branch protection and project details.

Project settings control core project behavior. Access from the gear icon within any project, then select General.

## Main branch protection rules

Protect the main branch by requiring approval before changes can be merged.

### Approval modes

| Mode            | Behavior                                                          |
| --------------- | ----------------------------------------------------------------- |
| None            | Direct commits allowed, no review process                         |
| Open Request    | Creates a change request for visibility, but no approval required |
| Single Approval | One team member must approve before merge                         |
| Group Approval  | One member from each assigned group must approve                  |

### Configuring protection

1. Go to Settings → General
2. Expand "Main branch protection rules"
3. Select an approval mode
4. Click Update

## Update project

Change the project name or identifier.

| Field       | Description                                           |
| ----------- | ----------------------------------------------------- |
| Name        | Display name shown in the UI                          |
| Project key | URL-friendly identifier used in APIs and integrations |

### Changing the project key

The project key appears in URLs and API calls. Changing it affects all existing integrations.

1. Expand "Update project"
2. Enter the new name or project key
3. Check "I accept the risk" (required for key changes)
4. Click Update

Update any external integrations to use the new project key after changing it.

## Danger zone

Permanently delete the project and all its data.

### Deleting a project

1. Expand "Danger zone"
2. Check "I would like to delete this project"
3. Click "Delete project"
4. Confirm the deletion

This action is irreversible. All rules, releases, branches, and history will be permanently removed.