> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin Guide

> How to use the admin dashboard, manage users, and configure site settings in Equa

# Admin Guide

The Admin Panel is the platform-level control center for Equa administrators. Unlike organization-level roles, admin access operates across all organizations and users on the platform. This guide covers user management, site statistics, and abuse prevention tools.

## Prerequisites

* Active Equa account
* Global admin role assigned by a platform operator

## Understanding Admin vs. Organization Roles

| Scope              | Description                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------- |
| Organization roles | Control what a member can do within a single organization (managed in Settings > Roles)       |
| Global admin roles | Control platform-wide actions across all users and organizations (managed in the Admin Panel) |

Admin privileges are granted through the global roles system and are not tied to any specific organization.

## Accessing the Admin Panel

### Step 1: Navigate to the Admin Panel

If you have admin access, click **Admin** in the main navigation bar. This opens the admin dashboard.

### Step 2: Review the Dashboard

The admin dashboard shows platform-wide statistics:

* **Total users** — Number of registered accounts
* **Total organizations** — Number of organizations on the platform
* **Active sessions** — Current logged-in users
* **Recent sign-ups** — New registrations over recent periods
* **Storage usage** — Total file storage consumed

## Common Tasks

### Managing Users

#### Searching for a User

1. Navigate to **Admin > Users**
2. Enter an email address in the search bar
3. Click **Search** to find the user

#### Viewing User Details

Click on any user in the list to see their:

* Account information (email, registration date, verification status)
* Organizations they belong to
* Session activity

#### Enabling or Disabling a User Account

1. Find the user in the user list
2. Click **Disable** to prevent them from logging in, or **Enable** to restore access
3. Confirm the action

Disabled users cannot log in but their data is preserved.

### Managing Blacklists

#### Adding an Email to the Blacklist

1. Navigate to **Admin > Blacklists > Email**
2. Click **Add Email**
3. Enter the email address to block
4. Click **Save**

Blacklisted emails cannot register or receive invitations.

#### Adding a Domain to the Blacklist

1. Navigate to **Admin > Blacklists > Domains**
2. Click **Add Domain**
3. Enter the domain (e.g., "spam-domain.com")
4. Click **Save**

All email addresses from the blacklisted domain are blocked from registration and invitations.

#### Removing a Blacklist Entry

1. Find the entry in the appropriate blacklist
2. Click **Remove**
3. Confirm the action

### Viewing Platform Statistics

The admin dashboard provides at-a-glance metrics:

* **User growth** — Track registration trends over time
* **Organization growth** — Monitor new organization creation
* **Session activity** — See how many users are currently active
* **Storage consumption** — Monitor total file storage used

### Monitoring for Abuse

Watch for signs of abuse in the admin dashboard:

* Unusually high registration rates from a single IP
* Multiple accounts registered from the same email domain
* Accounts created solely for referral rewards

Use the email and domain blacklists to block abusive patterns.

## Tips

<Tip>
  Use the email search to quickly find and support individual users. This is faster than scrolling through the full user list.
</Tip>

<Tip>
  Domain blacklists are more powerful than individual email blacklists — they block all addresses from a domain at once. Use them for known spam or disposable email domains.
</Tip>

<Tip>
  Disabling a user account is reversible. If you need to temporarily suspend someone's access, disable their account rather than deleting it.
</Tip>

## Design References

Design-system source for this guide: [Admin screenshot gallery](/architecture/design-system/screenshots/admin) and [EquaTable](/architecture/design-system/components/equa-table), [EquaBadge](/architecture/design-system/components/equa-badge), [EquaModal](/architecture/design-system/components/equa-modal), [EquaAlert](/architecture/design-system/components/equa-alert).

## Troubleshooting

<AccordionGroup>
  <Accordion title="I cannot access the Admin Panel">
    **Cause:** You do not have a global admin role assigned.

    **Solution:** Global admin access must be granted by an existing platform operator through the database or admin API. Contact your technical team.
  </Accordion>

  <Accordion title="A user reports they cannot register">
    **Cause:** Their email address or email domain may be on a blacklist.

    **Solution:** Check the email and domain blacklists in the Admin Panel. Remove the entry if the user should be allowed to register.
  </Accordion>

  <Accordion title="Platform statistics seem stale">
    **Cause:** Statistics are computed from database queries and may have a short cache period.

    **Solution:** Refresh the admin dashboard to get the latest counts. Statistics reflect the current state of the database.
  </Accordion>
</AccordionGroup>

## Related

* [Roles and Permissions](/guides/roles-and-permissions)
* [Managing Team Members](/guides/managing-team-members)
* [Getting Started](/guides/getting-started)
* [Admin Panel Specification](/specs/019-admin-panel/spec)