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

# Organizations & Teams

> Manage your Greptile organization: navigate the org/team hierarchy, invite members, assign roles, sync settings, and configure team-level access.

Greptile has **organizations** (your workspace) and **teams** (each GitHub org or GitLab group you connect).

## One org vs. multiple

**One connected org or group** — most workspaces look like this. The top-left breadcrumb shows your workspace name only. Use **Settings** for members, billing, and providers.

**Two or more connected orgs or groups** — the breadcrumb shows `Workspace / team-name`. Pick a team from the dropdown to switch context. **Settings** then shows that team's pages, including **People** for team-specific member access.

![Workspace dropdown showing org and team hierarchy](https://mintcdn.com/greptile/Y8YwftlC0YkMide_/images/workspace-dropdown.png?fit=max\&auto=format\&n=Y8YwftlC0YkMide_\&q=85\&s=f3c1a6966ddd2cbe284db8aece5fcfa9)

Workspace dropdown in the top-left breadcrumb

> [!NOTE]
>
> Steps below that mention a team's **Settings → People** only apply when you have multiple teams connected. With one team, **Settings → People** covers the whole workspace.

## Roles

### Organization roles

Set under **Settings → People**.

* **Admin** — Billing, members, code providers, integrations, and organization-wide review settings.
* **Member** — Day-to-day use: analytics, repos, pull requests, and custom context. Cannot change billing, providers, or org-wide settings.
* **Viewer** — Read-only access to analytics, repos, pull requests, and custom context.

At least one admin must remain. The last admin cannot be removed until another is promoted.

Enterprise plans can also define [custom roles](https://www.greptile.com/docs/account/organization-settings.md#roles-beta) and assign them here.

### Team roles

Only relevant with multiple teams connected. Select the team, then set under **Settings → People**.

* **Admin** — Manage members for that team. Cannot edit **Code Review Settings** (organization admins only).
* **Member** — View team repos, pull requests, and custom context; enable or disable repos for that team.

Organization admins always have full access to every team.

## Adding members

**1. Go to Settings**

Open **Settings → People**.

**2. Invite members**

Click **Invite people**, or use **Member link** to share an invite link.

![Organization people management](https://mintcdn.com/greptile/K-FC2J_U4wd5OfKX/images/org-settings-people.png?fit=max\&auto=format\&n=K-FC2J_U4wd5OfKX\&q=85\&s=657a517cac11b46aa476a59f9e661227)

Manage organization members

**3. Assign roles**

Choose **Admin**, **Member**, **Viewer**, or one of your custom roles.

To limit someone to a specific GitHub org or GitLab group, select that team in the breadcrumb, then open **Settings → People**.

![Team people management](https://mintcdn.com/greptile/K-FC2J_U4wd5OfKX/images/team-settings-people.png?fit=max\&auto=format\&n=K-FC2J_U4wd5OfKX\&q=85\&s=0b3ae812dea2513a0012257bff2914d6)

Team member access (multiple teams only)

## Managing repositories

Open **Settings → Add/Remove Repos** to enable or disable repos.

![Manage Repositories page with the repository table](https://mintcdn.com/greptile/MPBugESvutF83lxr/images/manage-repos.png?fit=max\&auto=format\&n=MPBugESvutF83lxr\&q=85\&s=068db574eeba43122dd25998d2b01517)

Enable or disable repositories

Select repositories in the list, then enable or disable them. The **Status** column shows which repos Greptile currently reviews.

Organization admins can manage repos across the whole workspace. With multiple teams, team members can also manage repos for their team.

### Auto-enable new repositories

1. Go to **Settings → Repo Settings** (under **Repositories**)
2. Toggle **Auto-enable new repos**

Only organization admins can change this.

![Repo Settings with the Auto-enable new repos toggle](https://mintcdn.com/greptile/Y8YwftlC0YkMide_/images/auto-enable-and-sync.png?fit=max\&auto=format\&n=Y8YwftlC0YkMide_\&q=85\&s=d6a3c88eace2f8a403fb5bbb812c3ad4)

Auto-enable new repos

## Syncing settings across teams

With multiple teams, each team can inherit review settings from the organization. On a team's **Code Review Settings** page, use **Inheritance & Sync**:

* **Sync from Parent** — match organization defaults
* **Sync Now** — sync immediately (disabled when already in sync)

Organization-level custom rules also appear on each team's **Memory → Custom rules** page as inherited.

[Review tiers](https://www.greptile.com/docs/code-review/review-tiers.md) and tier rules inherit the same way. A team uses the organization's tier until it sets its own.

## Onboarding for invited members

New members land in the org dashboard and are guided through **Personal Settings → Review Settings**:

1. Link GitHub or GitLab profile
2. Install the bridge app
3. Choose coding agents for Fix with your Agent

Members can also set personal preferences for summaries, diagrams, collapsible sections, and comments outside the diff.

> [!NOTE]
>
> **Members** do not see **Code Providers** or **Integrations** — admins only.

## Code providers

Admins connect GitHub, GitLab, Bitbucket, Cursor Origin, or Gitea under **Code Providers**. Click **Connect** or **Add Provider** to connect a provider. See [Code providers](https://www.greptile.com/docs/integrations/code-providers.md) for setup, access requirements, and on-premises Perforce support.

![Code Providers page with the Connect menu open](https://mintcdn.com/greptile/MPBugESvutF83lxr/images/code-providers.png?fit=max\&auto=format\&n=MPBugESvutF83lxr\&q=85\&s=d5830515f08bbf53ae26df221b0b00cb)

Connect a code provider

> [!TIP]
>
> If a GitHub organization does not appear when you add a provider, see [GitHub organization not listed](https://www.greptile.com/docs/troubleshooting/common-issues.md#github-organization-not-listed-on-greptile).

## What's next?

* [Set who can use Greptile](https://www.greptile.com/docs/account/organization-settings.md#permissions-beta)
* [Configure review settings](https://www.greptile.com/docs/code-review/controlling-nitpickiness.md)
* [Add custom standards](https://www.greptile.com/docs/code-review/custom-standards.md)
* [View analytics](https://www.greptile.com/docs/account/analytics.md)


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