# Global Subdomains

> Manage the global domains and their SRV mappings for the subdomain system.

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/subdomains` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `AdminSubdomainsPage` |
| Source | `src/app/(app)/admin/subdomains/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.subdomains.title` |
| Description i18n key | `admin.subdomains.description` |
| Permission | `admin.subdomains.view` |
| Nav group | `content` |
| Sidebar label | Subdomains |

## Summary (for AI)

**Global Subdomains** Manage the global domains and their SRV mappings for the subdomain system. Sidebar label: “Subdomains”. Requires permission `admin.subdomains.view`. Key UI: User subdomains are now enabled for clients.; User subdomains are now disabled for clients.; User-made subdomains are turned off; Allow users to create and manage server subdomains; User subdomains are enabled; Active.

## How to guide users

1. Open Admin sidebar.
2. Open **Subdomains**, then **Global Subdomains**.
3. Direct URL: `/admin/subdomains`.
4. User needs permission `admin.subdomains.view` (or `admin.root`).

## Sections on this page

_None extracted._

## Notable UI actions / labels

- User subdomains are now enabled for clients.
- User subdomains are now disabled for clients.
- User-made subdomains are turned off
- Allow users to create and manage server subdomains
- User subdomains are enabled
- Active
- Inactive
- Edit
- Delete
- No description provided.
- Cloudflare Settings
- Save Changes

## Widget slugs

- [`admin-subdomains`](../widgets/admin-subdomains.md)

## Related APIs / hooks

- `/api/admin/subdomains`
- `/api/admin/subdomains/settings`
- `/api/admin/subdomains/spells`

Hooks: `usePersistedListFilters`, `usePluginWidgets`
