Organization Settings

Manage organization name, image, and deletion.

The organization settings page allows members to manage their organization's profile and, for owners, perform administrative actions like deletion.

  • Route: /settings/organization
  • Location: apps/web/app/[locale]/(internal)/settings/organization/page.tsx
Organization settings page

Organization Settings

The settings page is organized into the following sections:

Upload or change the organization's logo. This image appears in the account switcher and throughout the application wherever the organization is displayed. The logo helps team members quickly identify their workspace.

The component that handles the organization logo upload is UpdateOrganizationImageForm.

Organization Name

Update the organization's display name. This name appears in the sidebar, account switcher, and any team-related interfaces. Changing the name does not affect the organization's URL slug or internal identifier.

The component that handles the organization name update is UpdateOrganizationNameForm.

Roles Management

Create and manage custom roles for your organization.

  • Route: /settings/roles
  • Location: apps/web/app/[locale]/(internal)/settings/roles/page.tsx

From this page you can:

  • View all roles (default and custom) with member counts
  • Create new custom roles with specific permissions
  • Configure role permissions via the Permission Matrix
  • Edit or delete custom roles

Only users with sufficient permissions (admin or owner) can access roles management.

For detailed documentation, see Custom Roles.

Danger Zone

The danger zone contains irreversible actions that require careful consideration.

Deleting an Organization

Only users with the required permissions can delete an organization. This action is permanent and cannot be undone.

There are two more requirements for deleting an organization:

  1. The organization must have no active subscriptions
  2. The user must verify their identity via email OTP

The result of the operation is immediate and irreversible.

The component that handles the organization deletion is located in packages/organization/ui/src/components/settings/delete-organization-dialog.tsx.

You can add custom authorization rules for deletion (and other operations) using Authorization Policies.

Next: Members Management →