Overview
The domain search page at /domain-search lets anyone check whether a domain name is available — no login required. It queries all active TLDs configured in Commerce and returns availability results in real time.
Using the Domain Search
- Navigate to
/domain-search. - Enter a domain name in the search box — type only the second-level label (e.g.
mycompany, notmycompany.com). - Click Search or press Enter.
- Results appear in a table, one row per active TLD.
Results Table
| Column | Details |
|---|---|
| Domain | Full domain name (e.g. mycompany.com) |
| Availability | Colour-coded badge |
| Price | Registration price for 1 year in the visitor's currency |
| Action | Register button (available domains only) |
Availability Colours
| Colour | Meaning |
|---|---|
| Green | Available — can be registered |
| Red | Taken — already registered |
| Grey | Unknown — registrar did not return a result (WHOIS timeout) |
[!TIP] Grey results usually indicate a WHOIS rate limit or a temporary registrar connectivity issue. The client can try again in a few seconds or search for a different TLD.
Registering a Domain from Search Results
Clicking the Register button on an available result behaves differently depending on whether the visitor is logged in:
- Guest (not logged in): Redirected to
/client/login. After login, the client is returned to the domain registration form with the domain pre-filled. - Logged-in client: Taken directly to the domain registration order form.
The domain registration form is the standard order form for the selected TLD's product. It includes:
- The domain name (pre-filled, read-only)
- Registration period selector
- Nameserver fields (optional — defaults to Commerce's default nameservers if left blank)
- WHOIS privacy option (if the TLD supports it)
- Order total and payment step
TLD Visibility
Only TLDs with is_active = true in the TLD manager appear in domain search results. Inactive TLDs are hidden regardless of whether they have pricing configured.
To manage TLDs: Admin → Domains → TLD Manager.
[!IMPORTANT] Setting a TLD to inactive removes it from search results and the store immediately. It does not affect domains already registered under that TLD.
Domain Search Widget on the Portal Home Page
The domain search can also be embedded as a prominent search widget on the portal home page (/).
To enable it:
- Go to Admin → Settings → Client Portal.
- Toggle Show domain search on home page to on.
- Save.
The widget shows a single search bar on the home page hero or a designated section. Results open inline on the home page rather than navigating to /domain-search.
Admin Configuration
| Setting | Location |
|---|---|
| Activate/deactivate TLDs | Admin → Domains → TLD Manager |
| Set TLD pricing | TLD Manager → edit TLD → Pricing tab |
| Set default nameservers | Admin → Settings → Domains → Default Nameservers |
| Enable domain search widget on home | Admin → Settings → Client Portal |
| Set WHOIS privacy availability per TLD | TLD Manager → edit TLD → toggle "Supports WHOIS privacy" |