Queries
useListOrganizations
List organizations available to the current user.
Organization queries require organizationClient() on your Better Auth client. Queries that depend on a signed-in user wait for session data before calling Better Auth.
Usage
import { useAuth, useListOrganizations } from "@better-auth-ui/react"
const { authClient } = useAuth()
const result = useListOrganizations(authClient)Client options factory and router-loader helpers
import {
ensureListOrganizations,
fetchListOrganizations,
listOrganizationsOptions,
prefetchListOrganizations
} from "@better-auth-ui/react"
const options = listOrganizationsOptions(authClient, userId)
await ensureListOrganizations(queryClient, authClient, userId)
await prefetchListOrganizations(queryClient, authClient, userId)
const organizations = await fetchListOrganizations(queryClient, authClient, userId)Notes
useActiveOrganizationtreatsslug: undefinedas the session active organization, a string slug as a URL-selected organization, andslug: nullas intentionally no active organization.- Member, invitation, and permission helpers follow upstream active-organization fallback behavior when an organization id is not provided.
useHasPermissionpreserves Better Auth's flat permission parameter shape.
Server-side prefetching
For server loaders, import from @better-auth-ui/react/server. The server helper uses your Better Auth server instance and the signed-in userId so the cache key stays partitioned per user.
import { ensureListOrganizations } from "@better-auth-ui/react/server"
import { getRequestHeaders } from "@tanstack/react-start/server"
import { auth } from "@/lib/auth"
await ensureListOrganizations(queryClient, auth, userId, {
headers: getRequestHeaders()
})Params
Prop
Type
Last updated on