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.
For general steps to troubleshoot problems in WHMCS, see Start Troubleshooting.

Domain Pricing

For more information, see Domain Pricing.

You may encounter the following common issues:

Error or Issue	Cause	Next Steps
`There was an error in your request` or `There was a problem connecting to the domain registry`	There is a Whois-related problem or a problem with your pricing for an extension.	Domain Availability Errors
The system is not saving changes to your domain pricing or `The system could not process your submission because PHP’s max_input_vars setting is too low.`.	The amount of data that the page is submitting exceeds the limit in your PHP configuration.	Domain Pricing Will Not Save
A domain that should be free is displaying the full price.	The items currently in the cart do not meet the criteria for the free domain discount.	Free Domain Is Not Free
`Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate`	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	Cause	Next Steps
The Choose a Domain page is blank in the Client Area.	You have not enabled any domain registration options.	Blank Choose a Domain Page
A domain search returns no results and renders a blank page.	The system encountered an incorrect response type.	Blank Domain Search Results
`There was an error in your request` or `There was a problem connecting to the domain registry`	There is a Whois-related problem or a problem with your pricing for an extension.	Domain Availability Errors

Domain Registration and Domain Registrars

Registrar Error messages 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	Cause	Next Steps
An error states that the admin contact details are missing, incomplete, or invalid.	There is a problem in your domain contact details configuration.	Missing Contact Details Errors

CentralNic Reseller

You may encounter the following common issues while using CentralNic Reseller:

Error or Issue	Cause	Next Steps
`Entity reference not found`	The domain does not exist in your CentralNic Reseller account.	Entity Reference Errors

Enom

You may encounter the following common issues while using Enom:

Error or Issue	Cause	Next Steps
`Bad User name or Password`	The credentials in your Enom configuration are incorrect.	Bad User name or Password Errors

Domain Management

For more information, see Selling and Managing Domains.

You may encounter the following common issues:

Error or Issue	Cause	Next Steps
`Oops! ERROR: WHMCS\Exception\InvalidDomain: The domain is invalid. in /path/to/whmcs/vendor/whmcs/whmcs-foundation/lib/Domains/Idna.php:0`	The `tbldomains.domain` field in your MySQL® database contains an invalid character.	Domain Management Oops! Errors
An error states that the admin contact details are missing, incomplete, or invalid.	There is a problem in your domain contact details configuration.	Missing Contact Details Errors
An error states that the registrant contact details are missing, incomplete, or invalid.	There is a problem with the contact details in the client’s profile.	Missing Registrant Contact Errors

Domain Renewal

For more information, see Domain Renewals.

You may encounter the following common issues:

Error or Issue	Cause	Next Steps
`Suppressed Automatic Domain Renewal on Payment Due to Domain Being Free and having No Active Associated Product`	You enabled the Auto Renew Requires Product setting.	Suppressed Renewal Errors

Domain Transfers

For more information, see Domain Transfers.

You may encounter the following common issues:

Error or Issue	Cause	Next Steps
`Entity reference not found`	The domain does not exist in your CentralNic Reseller account.	Entity Reference 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

Last modified: January 14, 2025