Overview
Commerce provides a full domain management interface for both admins and clients. Admins have access to all controls plus notes and manual sync. Clients can manage their own domains at /client/domains.
Admin Domain List
Location: Admin → Domains
The list table shows:
| Column | Description |
|---|---|
| Domain name | Full domain, clickable to detail |
| TLD | Extension |
| Registrar | Module slug of the registrar used at registration |
| Expiry | Expiry date with color indicator (red = < 30 days) |
| Status | Badge: active / pending / expired / etc. |
| Auto-renew | Icon: on or off |
| Actions | Quick-access icons (sync, lock, edit) |
Domain Detail Page
Click any domain name to open the detail page. It is organized into sections:
Info Panel
| Field | Description |
|---|---|
| Registered | Date of registration |
| Expiry | Current expiry date |
| Registrar | Module used at registration |
| Billing cycle | Annual / multi-year |
| Amount paid | Total paid for current registration term |
Nameservers
Four editable fields: ns1, ns2, ns3, ns4. Clicking Save Nameservers calls updateNameservers(domain, [ns1, ns2, ns3, ns4]) on the registrar module and updates the domains record on success.
WHOIS Privacy
Toggle switch. Available only if the TLD has whois_privacy_available = true. Calls setPrivacy(domain, true/false) on the registrar. See WHOIS Privacy for details.
Transfer Lock
Toggle switch. Calls setLock(domain, true/false). Enabled by default on registration. Must be disabled before a transfer-out can proceed. See Domain Lock & EPP Code.
EPP Code
Get EPP Code button. Fetches the auth code on demand via getEppCode(domain). Shown once to the admin. Not stored in Commerce. See Domain Lock & EPP Code.
Contacts
Summary of registrant, admin, tech, and billing WHOIS contacts stored in domain_contacts. Edit link opens the contact edit form (local update only — use Sync to push to registrar if needed).
Sync
Sync Domain button. Calls getDomainInfo(domain) on the registrar and updates the local record with current expiry, status, and nameservers. Use after manual changes made directly at the registrar.
Notes (Admin Only)
Free-text notes field. Visible only to admins. Useful for migration notes, support history, or manual action records.
Client Domain Management
Available at /client/domains and /client/domains/{domain}.
Clients can:
- View domain list with expiry and status
- Edit nameservers
- Toggle WHOIS privacy (if available)
- Toggle auto-renew
- Request EPP code
- Toggle domain lock
Clients cannot:
- View or edit admin notes
- Trigger a manual sync
- Change the registrar or TLD
Status Badge Guide
| Status | Meaning | Client action needed |
|---|---|---|
active |
Live and registered | None |
pending |
Registrar action in progress | None — wait |
expired |
Past expiry | Pay renewal invoice |
redemption |
In redemption period at registrar | Contact support — extra fee may apply |
transferred_away |
Moved to another registrar | No further action |