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

# Settings

> Find and change every account, company, and automation setting from one place

## Overview

Every setting in Corgea lives under **Settings**, organized into four categories: **Company**, **User Management**, **Automation**, and **Personal**. Each category groups the pages that belong together, so you no longer have to hunt through the sidebar to find where something is configured.

## Opening Settings

Click **Settings** near the bottom of the sidebar. This always opens **Personal → Profile**, and from there you pick any section from the rail on the left.

<div style={{ maxWidth: '26rem' }}>
  <Frame caption="The sidebar groups collapse, but Settings stays pinned at the bottom. A company on a pilot plan also shows the remaining trial time.">
    <img src="https://mintcdn.com/corgea/L-24If3t2LOPrEXE/images/settings/sidebar_views.png?fit=max&auto=format&n=L-24If3t2LOPrEXE&q=85&s=6d1bfff89582f19bc51b0b096ed6c176" alt="The Corgea sidebar expanded and collapsed, with Settings pinned at the bottom of both" width="410" height="1028" data-path="images/settings/sidebar_views.png" />
  </Frame>
</div>

Two shortcuts are worth knowing:

* **Search settings** at the top of the page (or <kbd>⌘</kbd><kbd>K</kbd>) jumps straight to a section by name. Searching "content" takes you to Content access, for example.
* The theme toggle in the top-right corner switches between light and dark.

On a narrow screen the rail collapses into a drawer you open from the header.

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/settings_overview.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=85f85ba581170914efa1d2521e4dd206" alt="The Settings page showing all four categories in the left rail" width="1919" height="905" data-path="images/settings/settings_overview.png" />
</Frame>

## What You Can See

The rail only lists sections you have access to. Which sections appear depends on your [role](/permission_groups) and your plan, so two people in the same company can see different rails.

A user with no administrative permissions sees only the **Personal** category:

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/settings_non_admin.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=d12729e079b86fe278eaecf210fa73f7" alt="Settings for a user without administrative permissions, showing only the Personal category" width="1666" height="990" data-path="images/settings/settings_non_admin.png" />
</Frame>

## Changes Save Automatically

Settings pages save as you go. Toggle a switch or pick an option and Corgea persists it in the background, confirming with a brief **Saved** indicator. There are no **Save** buttons to click.

There are three exceptions. The analytics consent controls on **Preferences** require an explicit **Save cookie preferences** click because they govern tracking consent. The token expiry on **API token** is applied with **Update Expiration**. The company-wide **Default Timezone** on **Users** is applied with **Save**.

## Personal

Settings that apply to your own account only.

### Profile

**Settings → Personal → Profile** ([open](https://www.corgea.app/settings/user/))

Your name, the email address you sign in with, your company, and your role. **Change password** sends a password reset link to your email.

If you're a company admin, the **Company** field is editable here and renaming the company applies for everyone. Other users see the company name as read-only text. **Role** is always read-only and is set by your administrator.

The **Release** card shows the Corgea version you're running, with a link to the [changelog](/changelog).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/profile.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=7da6a19b2155b0f25a6ca721b3f70449" alt="The Profile page showing your details, editable company name, and read-only role" width="1666" height="988" data-path="images/settings/profile.png" />
</Frame>

### Preferences

**Settings → Personal → Preferences** ([open](https://www.corgea.app/settings/user/preferences/))

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/preferences.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=407fcb353e21caf911c6ba314b7a1467" alt="The Preferences page with appearance, regional, and privacy controls" width="1666" height="990" data-path="images/settings/preferences.png" />
</Frame>

| Setting | What it does |
| - | - |
| **Diff view** | Whether fixes open **Line by line** or **Side by side** by default |
| **Fun mode** | Occasional celebratory flourishes in the interface |
| **Timezone** | Overrides your company's default timezone for your account only. Leave it on **Company default** to follow whatever admins have set |
| **Google Analytics** / **PostHog Analytics** | Analytics consent. Click **Save cookie preferences** to apply |

Preferences apply to your account on every device you sign in from.

### Notifications

**Settings → Personal → Notifications** ([open](https://www.corgea.app/settings/notifications/))

Which emails Corgea sends you. Each notification is set to **Inherit**, **On**, or **Off** — **Inherit** follows your company's default. See [Notifications](/notifications) for what each notification covers.

## Company

### Triage rules

**Settings → Company → Triage rules** ([open](https://www.corgea.app/settings/company/triage-approvals/))

Company admins can require a second reviewer before a finding is marked **False positive** or **Accepted risk**. When enabled, the finding stays unchanged until a different reviewer approves the request. Use the approvals queue to review pending requests; reviewers need **Can approve or reject triage requests** plus change permission for every finding type in the request.

<Frame>
  <img src="https://mintcdn.com/corgea/gXE6s3uSV4XQ0K2H/images/settings/triage_rules.png?fit=max&auto=format&n=gXE6s3uSV4XQ0K2H&q=85&s=aecf2cd18443c22cf898ed8a77c33603" alt="The Triage rules page with False positive and Accepted risk on, and two auto triage rules" width="1675" height="875" data-path="images/settings/triage_rules.png" />
</Frame>

Auto triage rules are available only when enabled for your company. Company admins manage them on this page, in **Auto triage rules**. Each rule matches a project name or repository URL with a case-insensitive glob (`*` matches anything, `?` matches one character). Rules run in list order. The first match that has not expired applies.

When a scan detects an open SAST or SCA finding with no triage comment, that rule sets the status and comment. An **Accepted risk** rule also sets the expiry date, and that date has to be in the future. This includes a finding from an earlier scan the next time a scan detects it, and, for SAST, an open finding with no triage comment that an incremental scan carries forward. A finding that already has a triage comment, or a status other than **Open**, is left unchanged. The rule sets the status directly and does not create a triage approval request.

<Frame>
  <img src="https://mintcdn.com/corgea/gXE6s3uSV4XQ0K2H/images/settings/auto_triage_rule_modal.png?fit=max&auto=format&n=gXE6s3uSV4XQ0K2H&q=85&s=3302520d59fa3a425b05a2d3e7f0a69d" alt="Add auto triage rule dialog with Issue creation selected, an empty pattern, and an empty default status" width="807" height="699" data-path="images/settings/auto_triage_rule_modal.png" />
</Frame>

### Notification defaults

**Settings → Company → Notification defaults** ([open](https://www.corgea.app/settings/company/notifications/))

The starting point for everyone in the company: which emails are on by default, and who receives them. Company admins only. See [Notifications](/notifications).

### Billing

**Settings → Company → Billing** ([open](https://www.corgea.app/settings/company/billing/))

Your plan, usage, and invoices. Requires permission to view company details.

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/billing.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=86c1aea36b9cdb1edbb8962c5944eec3" alt="The Billing page showing the current plan, seat usage, and plan comparison" width="1666" height="988" data-path="images/settings/billing.png" />
</Frame>

## User Management

### Users

**Settings → User Management → Users** ([open](https://www.corgea.app/settings/company/members/))

Invite, deactivate, and reactivate people, and assign their roles. Company admins also set the **Company name** and the company-wide **Default Timezone** on the **Company Settings** tab of this page. See [User Management](/user_management).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/users.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=c50f0b4fa8acd00f808f8d7316e9f21d" alt="The Users page listing everyone in the company with their roles and teams" width="1666" height="990" data-path="images/settings/users.png" />
</Frame>

### Roles

**Settings → User Management → Roles** ([open](https://www.corgea.app/settings/company/groups/))

Roles and the permissions each one grants. Requires a plan that includes role management. See [Roles](/permission_groups).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/roles.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=41cb2241a9e5ecb814e76386d6b04c6b" alt="The Roles page listing each role and how many users it has" width="1666" height="770" data-path="images/settings/roles.png" />
</Frame>

### Teams

**Settings → User Management → Teams** ([open](https://www.corgea.app/settings/company/teams/))

Group people together and grant the whole team access to projects. Requires a plan that includes teams. See [Teams](/teams).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/teams.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=b9978dd974d7ebba5543ece05ce8530d" alt="The Teams page listing each team with its members and projects" width="1666" height="988" data-path="images/settings/teams.png" />
</Frame>

### Content access

**Settings → User Management → Content access** ([open](https://www.corgea.app/settings/company/content-access/))

Control which projects each person and team can see. Requires a plan that includes teams. See [Content Access Management](/content-access-management).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/content_access.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=603138a86c4a9567d058882b18b6c198" alt="The Content access page showing which users and teams can reach each project" width="1666" height="988" data-path="images/settings/content_access.png" />
</Frame>

## Automation

### Corgea Agent

**Settings → Automation → Corgea Agent** ([open](https://www.corgea.app/settings/company/corgea-agent/))

Turn the agent on or off and configure how it triages and fixes issues. See [Corgea Agent](/agent).

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/corgea_agent.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=2c6c0cdf130b472c83f7866f545dfb3f" alt="The Corgea Agent page with the Enable Corgea Agent toggle" width="1666" height="770" data-path="images/settings/corgea_agent.png" />
</Frame>

### Integrations

**Settings → Automation → Integrations** ([open](https://www.corgea.app/settings/integrations/))

Source control, ticketing, scanners, webhooks, package registries, and SAML SSO. Every integration guide in these docs starts here.

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/integrations.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=c254c3028e4589521967e7dbf90037ff" alt="The Integrations page with integrations grouped by category" width="1666" height="990" data-path="images/settings/integrations.png" />
</Frame>

### API token

**Settings → Automation → API token** ([open](https://www.corgea.app/settings/integrations/api-token/))

Your personal token for the [CLI](/cli), the IDE extensions, the [MCP server](/modelcontextprotocol), and the [public API](/api-reference/introduction). You can show, copy, and rotate the token, and set an expiration date for it.

<Warning>
  Rotating your token immediately invalidates the old one. Update it anywhere you've stored it — CI pipelines, IDE extensions, and local CLI configuration.
</Warning>

<Frame>
  <img src="https://mintcdn.com/corgea/5JASlqJeHwNT0QGq/images/settings/api_token.png?fit=max&auto=format&n=5JASlqJeHwNT0QGq&q=85&s=f9b3837060499861aa5ab5f97bc6aa03" alt="The API token page with the masked token, show, copy, and rotate controls, and the expiration field" width="1666" height="990" data-path="images/settings/api_token.png" />
</Frame>

## Where Things Moved

If you have an old link or bookmark, it still works — Corgea redirects it to the new location.

| Previously | Now |
| - | - |
| User Settings | **Personal → Profile** and **Personal → Preferences** |
| Notifications, with a Company Defaults section at the top | **Personal → Notifications** and **Company → Notification defaults** |
| `/billing/` | **Company → Billing** |
| `/users` | **User Management → Users** |
| Permission Groups | **User Management → Roles** |
| `/teams` | **User Management → Teams** |
| `/content-access` | **User Management → Content access** |
| Agent Settings | **Automation → Corgea Agent** |
| `/integrations/` | **Automation → Integrations** |
| The API token section on the Integrations page | **Automation → API token** |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.