Organization Settings

The organization settings page lets members manage the organization's profile. Owners can perform administrative actions including deletion.

Organization settings provide a centralized page for managing organization profile (name, logo), custom roles, and administrative actions. Access is role-based: all members view settings, admins edit profiles, and only owners can delete organizations. The settings page shares the /settings route with personal accounts - context determines the displayed content.

Organization settings is a protected route (/settings) where team members manage organization-level configuration: display name, logo, custom roles, and danger zone operations (deletion).

Settings Sections

Organization Logo

Upload or change the organization's logo. The image appears in:

• Account switcher dropdown
• Sidebar header
• Member lists
• Anywhere the organization is displayed

Supported formats: PNG, JPG, WebP. Images are resized and optimized automatically.

Organization Name

Update the display name shown throughout the app. Changing the name:

• ✅ Updates display in sidebar, switcher, and UI
• ❌ Does NOT change the organization's internal ID
• ❌ Does NOT affect the URL slug

Roles Management

Access at /settings/roles. Requires admin or owner permissions.

For details, see Custom Roles.

Danger Zone

Deleting an Organization

This action is permanent and cannot be undone. All organization data, members, and settings are deleted immediately.

To add custom deletion rules (e.g., require data export first), see Authorization Policies.

Accessing Settings Data

Use the workspace hook to access current organization settings:

'use client';
import { useTeamAccountWorkspace } from '@kit/team-accounts/hooks/use-team-account-workspace';
function SettingsDisplay() {
  const { account } = useTeamAccountWorkspace();
  return (
    <div>
      <p>Organization: {account.name}</p>
      <p>ID: {account.id}</p>
      {/* account.pictureUrl for logo if set */}
    </div>
  );
}

Common Pitfalls

• Trying to delete with active subscription: Cancel the subscription first from /settings/subscription.
• Expecting slug changes: The organization name is display-only. Slugs are immutable after creation.
• Insufficient permissions: Only owners can delete organizations. Admins can manage settings but not delete.

Next: Authorization Policies →