Troubleshooting Domains
If you encounter errors or issues while working with domains, domain registration, or domain pricing and configuration, see the sections below to start troubleshooting and resolve the issue.
You can begin the troubleshooting process for most domain-related issues by reviewing recent error messages at Configuration () > System Logs.
For more information about domains in WHMCS, see Selling and Managing Domains.
Domain Configuration
For more information, see Domain Pricing.
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
| Clicking Save Changes does not save updates to domain pricing options. | The amount of data that the page is submitting exceeds the limit of the max_input_vars or post_max_size PHP configuration variables. | Domain Pricing Will Not Save |
Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate | This message occurs when a currency in WHMCS is missing or does not have a properly-configured exchange rate. | Unable to Display Pricing Errors |
Domain Availability
For more information, see Lookup Providers and Client Area Domain Registration.
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
| A domain search returns no results and renders a blank page. | This issue is usually due to an incorrect response type. | Blank Domain Search Results |
| Domain availability checker results are incorrect. or There was an error in your requestor There was a problem connecting to the domain registry | These errors indicate a Whois-related problem or a problem with your pricing configuration. | Domain Availability Errors |
Domains must begin with a letter or number | The most common cause of this issue is that you have configured WHMCS to use multiple currencies, but you have not configured a price for the currency that the client uses. | Domain Availability Errors |
Extension not listed in includes/whoisservers.php | This error indicates that the domain extension in the search is not configured on your server. | Domain Availability Errors |
Error: 110 - Connection Erroror Error: 110 - Network is unreachableor Error: 110 - Error detail unknown | This error indicates that WHMCS cannot access the Whois server in your /resources/domains/dist.whois.json file. This may be due to your firewall or another issue. | Domain Availability Errors |
Error: 0 - php_network_getaddresses: getaddrinfo failed: Name or service not known | This error indicates that the domain extension does not appear in the /resources/domains/dist.whois.json file or your server is unable to resolve it. | Domain Availability Errors |
The domain you entered is not valid | This error indicates that you have not configured pricing for the selected domain extension and WHMCS does not have a Whois server to check availability. | Domain Availability Errors |
Domain Registration
Registrar Errormessages when registering, transfering, or renewing domains are from the registrar module and not WHMCS itself. To troubleshoot these errors, go to Configuration () > System Logs and check for relevant error messages.- After you finish resolving a domain registrar issue, you can retry the module action. For steps, see Retry a Module Action.
For more information, see Domain Registrars.
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
| A free domain is not displaying as free in the shopping cart. | In most cases, this is because the items currently in the cart do not meet the criteria for the free domain discount. | Free Domain Is Not Free |
| A message states that the registrant’s contact details are missing, incomplete, or invalid. | There is a problem in the client’s details in the Profile tab in the client’s profile. | Missing Registrant Contact Errors |
| A message states that the admin’s contact details are missing, incomplete, or invalid. | There is a problem in your contact details in the Domains tab at Configuration () > System Settings > General Settings. | Missing Contact Details Errors |
| The Choose a Domain page is blank during the ordering process. | You enabled Require Domain in the product configuration but have not enabled any domain registration options. | Blank Choose a Domain Page |
Automatic Domain Registration on Payment Suppressed for New Clientor Automatic Domain Registration Suppressed as Domain Is Already Active | The domain is already registered, or a setting or the domain’s status is preventing WHMCS from registering it automatically. | Registration Suppressed Errors |
CURL Error: 56 - OpenSSL SSL_read: Successor CURL Error: 56 - OpenSSL SSL_read: error:14095126:SSL routines:ssl3_read_n:unexpected eof while reading, errno 0 | These errors are due to the following system updates to EasyApache 4. | OpenSSL Registrar Errors |
No nameservers are defined for the server this domain is assigned to | The service’s assigned server does not have any defined nameservers. | No Nameservers Are Defined Errors |
Domain Renewal and Management
For more information, see Domain Renewals.
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
| The system cancelled a domain renewal invoice unexpectedly. | This issue is due to your domain redemption or domain renewal settings. | Cancelled Domain Renewal Invoices |
ERROR: WHMCS\Exception\InvalidDomain: The domain is invalid. in /path/to/whmcs/vendor/whmcs/whmcs-foundation/lib/Domains/Idna.php:0 | There is an invalid character in the tbldomains.domain field in your MySQL® database. | Invalid Domain Errors |
Suppressed Automatic Domain Renewal on Payment Due to Domain Being Free and having No Active Associated Product | In many cases, this error occurs because you enabled Auto Renew Requires Product and the domain does not have an associated active product. | Free Domain Did Not Renew |
Last modified: June 14, 2024