# Organization Settings

> Manage organization name, image, roles, and deletion.

*Canonical: https://makerkit.dev/docs/nextjs-prisma/organizations/settings*

---

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.

| Property | Value |
|----------|-------|
| Shared Route | `/settings` |
| Related Routes | `/settings/members`, `/settings/roles`, `/settings/billing` |
| Base Location | `apps/web/app/[locale]/(internal)/settings` |

## Settings Areas

| Area | Route or Implementation |
|------|-------------------------|
| Organization profile | `packages/organization/core/src/services/update-organization.service.ts` |
| Organization image | `packages/organization/core/src/services/update-organization-image.service.ts` |
| Members | `/settings/members` |
| Roles | `/settings/roles` |
| Billing | `/settings/billing` |

## Reading Current Organization

```typescript
'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 →](./authorization-policies)