Overview
The TLD Manager is the admin interface for the domain_tlds table — the catalog of domain extensions Commerce offers for registration. Only TLDs marked active appear in client-facing domain search results.
Location: Admin → Domains → TLD Manager
TLD Record Fields
| Field | Type | Description |
|---|---|---|
| TLD | string | Extension without leading dot, e.g. com, net, co.uk |
| Register Price | integer (cents) | Retail price charged to client per registration year |
| Renew Price | integer (cents) | Retail price charged to client per renewal year |
| Transfer Price | integer (cents) | Retail price charged for inbound transfer |
| Min Years | integer | Minimum registration/renewal term (default: 1) |
| Max Years | integer | Maximum registration/renewal term (default: 10) |
| EPP Required | boolean | Whether an EPP code is required for transfers |
| WHOIS Privacy Available | boolean | Whether WHOIS privacy can be toggled for this TLD |
| Active | boolean | If off, TLD is hidden from domain search |
Prices are the amounts charged to clients. Your registrar wholesale cost is separate — set your markup accordingly.
Adding a TLD
- Go to Admin → Domains → TLD Manager → Add TLD.
- Enter the TLD string exactly as the registrar uses it (e.g.
com, not.com). - Set retail prices in cents (e.g.
1499= $14.99). - Set
min_yearsandmax_yearsbased on registrar policy. - Check EPP Required and WHOIS Privacy Available based on the TLD's registry rules.
- Toggle Active on to make it searchable immediately.
- Save.
Editing a TLD
Click any TLD row to edit. Price changes take effect immediately on the next domain search — they do not retroactively change existing orders.
Bulk Enable / Disable
Use the checkboxes in the TLD list to select multiple TLDs, then use the Bulk Actions dropdown to enable or disable them all at once. Useful when launching a new TLD batch or temporarily removing TLDs during a registrar switch.
Importing from a Registrar Price List
Most registrars provide a CSV or API endpoint listing their available TLDs and wholesale prices. Commerce does not auto-import from registrar APIs — import is a manual process:
- Download the registrar's TLD/pricing export.
- Add markup to each wholesale price.
- Enter TLDs individually via the Add TLD form, or use the bulk import tool if your plan includes it.
How the TLD String Is Used in API Calls
The Commerce registrar modules pass the tld column value as-is to the registrar API. For example, if the TLD is co.uk, the module sends co.uk in the registration request. Ensure the string matches what the registrar API expects — check the registrar's documentation if unsure.
Pricing Strategy Notes
- Register and renew prices are independent — many operators charge a lower first-year registration price than the renewal price.
- Transfer prices are often set to one year's renewal cost.
- WHOIS privacy may have an additional charge at some registrars. Factor this into pricing or charge separately via an add-on product.