## Roles

Use this page for account roles, account types, permissions, audit behavior, impersonation policy, and the reader-facing explanation of admin governance.

{% figure src="/docs-images/gitbook-products-roles.png" alt="GitBook roles product docs page" caption="The roles product guide gives readers a public explanation of account roles, permission boundaries, and governance topics before they assume self-service admin controls exist." /%}

## What to document

Explain which roles readers may encounter, how permissions differ from account type, where audit trails matter, and how impersonation or elevated access is governed. Keep it clear which role behavior is visible to ordinary users versus internal admins.

## Sensitive areas

When documenting security or governance topics, avoid implying that a self-service role editor exists unless the product surface truly supports it.

## Source of truth

Confirm role and permission language against the current schema, admin workflow specs, and live admin behavior before publishing governance guidance.