useOrganizationList

Call this React hook with configuration for the organization data you need. Memberships, invitations, and suggestions are not fetched unless their option is set to true or configured; the returned object also exposes loading state, pagination, organization creation, and active-organization management.

useOrganizationList(options?)

An object containing isLoaded, configured paginated organization resources such as userMemberships, userInvitations, and userSuggestions, plus methods including createOrganization() and setActive().

import { useOrganizationList } from '@clerk/react';

export function OrganizationSwitcher() {
  const { isLoaded, setActive, userMemberships } = useOrganizationList({
    userMemberships: {
      pageSize: 5,
      keepPreviousData: true,
    },
  });

  if (!isLoaded) return <p>Loading…</p>;

  return (
    <ul>
      {userMemberships.data?.map((membership) => (
        <li key={membership.id}>
          <button onClick={() => setActive({ organization: membership.organization.id })}>
            {membership.organization.name}
          </button>
        </li>
      ))}
    </ul>
  );
}

Loads the current user's organization memberships five at a time and lets each button make its organization active.