Organization Management

Organization Management gives admins read-only oversight of all teams on your platform. Search organizations, view member lists, check subscription status, and click through to individual user management. The admin panel currently provides viewing capabilities; modifying organizations (settings, members, deletion) is done through the standard team interface.

Organization billing depends on your account mode: Team Mode attaches billing to organizations, Personal Mode to individual users.

Organization List

Search

Use the search input to find organizations by name. Results update as you type and are paginated.

Table Columns

Each organization row displays:

Organization Details

Click "View Details" to open a side panel with comprehensive organization information.

Overview Section

• Logo and Name: Organization branding
• Slug: URL identifier for the organization
• Member Count: Total team members
• Created Date: When the organization was created

Subscription Information

When billing is enabled and the admin has subscriptions:list permission, the panel shows:

• Plan Name: Current subscription tier
• Status: Active, canceled, past due, etc.
• Billing Period: Monthly or yearly
• Next Billing Date: Upcoming renewal

Organizations inherit billing based on your account mode configuration:

• Team Mode: Billing attached to organizations
• Personal Mode: Billing attached to individual users

Member List

All organization members are displayed with:

• Avatar: Member's profile picture
• Name: Display name
• Email: Member's email address
• Role: Organization role (owner, admin, member)
• Status: Active or banned indicator

Click any member to open their User Details panel. This allows quick access to user management actions without leaving the organization view.

Permission Requirements

Organization management requires these RBAC permissions:

The default admin role has all permissions. For custom roles:

export default defineAdminRBACConfig({
  roles: {
    support: 50,
  },
  permissions: {
    support: {
      organizations: ['list', 'view'],
      subscriptions: ['list'],
      user: ['list', 'get'],
    },
  },
});

Data Loading

Organization data is loaded server-side with admin protection:

// packages/admin/src/organizations/lib/loaders/organizations-page.loader.ts
import 'server-only';
import { cache } from 'react';
import { requireAdmin } from '@kit/auth/require-admin';
export const loadOrganizationsPageData = cache(async (params) => {
  await requireAdmin();  // Ensures admin access
  const service = createOrganizationsAdminService();
  return service.listOrganizations({
    searchValue: params.search,
    limit: 25,
    offset: (params.page - 1) * 25,
    sortBy: params.sortBy,
    sortDirection: params.sortDirection,
  });
});

Member data is fetched on-demand when viewing organization details:

// Fetched via React Query when details panel opens
const { data: members = [], isLoading } = useQuery({
  queryKey: ['admin', 'organization-members', organizationId],
  queryFn: () =>
    getOrganizationMembersAction({ organizationId }).then(
      (result) => result.data?.members || []
    ),
});

Read-Only Access

The current admin panel provides read-only access to organizations. For modifying organizations (updating settings, managing members, deleting), users should access the organization directly through the standard team interface.

If you need admin actions for organizations, see Extending Admin for adding custom functionality.

Previous: User Management

Next: RBAC Permissions