# Blocked email domains

> Domains listed here cannot be used for new registrations or when users change their email, when blocking is enabled. Subdomains match (e.g. sub.example.com matches example.com).

## Identity

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

| Title i18n key | `admin.blocked_email_domains.title` |
| Description i18n key | `admin.blocked_email_domains.description` |
| Permission | `admin.settings.view` |
| Nav group | `system` |
| Sidebar label | Blocked Email Domains |

## Summary (for AI)

**Blocked email domains** Domains listed here cannot be used for new registrations or when users change their email, when blocking is enabled. Subdomains match (e.g. sub.example.com matches example.com). Sidebar label: “Blocked Email Domains”. Requires permission `admin.settings.view`. Key UI: Bulk import domains; Bundled preset; From URL; Paste text; Plain-text URL; Domain list.

## How to guide users

1. Open Admin sidebar.
2. Open **Blocked Email Domains**, then **Blocked email domains**.
3. Direct URL: `/admin/blocked-email-domains`.
4. User needs permission `admin.settings.view` (or `admin.root`).

## Sections on this page

_None extracted._

## Notable UI actions / labels

- Bulk import domains
- Bundled preset
- From URL
- Paste text
- Plain-text URL
- Domain list
- Enforcement
- Toggle whether the list below is applied at signup and email changes
- Enforce blocked domains
- Add domain
- Single entries are validated instantly
- Block a domain

## Widget slugs

_None detected._

## Related APIs / hooks

- `/api/admin/blocked-email-domains`
- `/api/admin/blocked-email-domains/import-preset`
- `/api/admin/blocked-email-domains/import-text`
- `/api/admin/blocked-email-domains/import-url`
- `/api/admin/settings`

Hooks: `usePluginWidgets`