Organization Settings

Manage organization name, image, roles, and deletion.

Organization settings share the /settings route with personal settings. When organization context is active, the settings area exposes organization profile, members, roles, billing, and deletion flows.

PropertyValue
Shared Route/settings
Related Routes/settings/members, /settings/roles, /settings/billing
Base Locationapps/web/app/[locale]/(internal)/settings

Settings Areas

AreaRoute or Implementation
Organization profilepackages/organization/core/src/services/update-organization.service.ts
Organization imagepackages/organization/core/src/services/update-organization-image.service.ts
Members/settings/members
Roles/settings/roles
Billing/settings/billing

Reading Current Organization

'use client';
import { useAccountContext } from '@kit/better-auth/hooks/use-account-context';
function OrganizationSettingsSummary() {
  const { activeOrganization } = useAccountContext();
  return <div>{activeOrganization?.name}</div>;
}

Common Pitfalls

  • Trying to delete with an active subscription: cancel billing first from /settings/billing.
  • Using nonexistent package paths from older docs: organization profile updates are handled by the core services above, not a packages/organization-settings package.
  • Expecting settings to live on a separate org-only route: organization and personal settings share the same route group.

Next: Authorization Policies →