<OrganizationProfile />

Organization profile settings

<OrganizationProfile /> is the organization settings surface. It gives owners and admins a place to update organization details, invite members, review pending invitations, and manage membership.

Most apps render it through <OrganizationProfileHost />, which is opened from <OrganizationSwitcher /> and synced to the URL.

Quick start

Mount the host once near the root of your app:

What it includes

  • General settings – update organization name, slug, and logo.
  • Members – review current members and role-gated actions.
  • Invitations – list pending invitations and invite new members.
  • Leave organization – let members leave safely.
  • Delete organization – owner/admin destructive flow with guardrails.
  • Responsive navigation – desktop tabs and mobile drill-in panels.

URL and mobile behavior

The profile uses ?dialog=organization-profile so users can reload into the same dialog and close it with the browser back button. Mobile sub-pages use a tab query param so iOS back-swipe returns from a section to the settings menu before closing the dialog.

Convex behavior

Organization and role data comes from Convex queries. Initial data can be passed from SSR for instant rendering, and profile updates use Convex mutations with optimistic updates where the UI benefits from immediate feedback.

Props

  • <OrganizationSwitcher /> – opens the organization profile.
  • <CreateOrganization /> – creates new organizations.
  • <MembersAndInvitations /> – members and invite management section.