Domain Sync Task
On this page
The domain sync task is responsible for ensuring that the next due date, expiry date, and status are up-to-date on all Pending Transfer, Pending Registration, and Active status domains that use a valid registrar module. This task runs as part of the system cron’s automation tasks.
The Domain Sync Task
The domain sync task uses each domain registrar module’s domain synchronization functions (if they exist) to check 50 domains per run from the oldest to newest in your WHMCS installation. The task handles Pending Transfer, Pending Registration, and Active status domains separately, so it can do 50 of each during each run.
- You can enable or disable this task using Domain Sync Enabled at Configuration () > System Settings > Automation Settings or by customizing how the system cron runs.
- You can adjust how often the system cron performs this task using Domain Expiry Sync Frequency and Pending Transfer Sync Frequency at Configuration () > System Settings > Automation Settings
Task Actions
The task performs the following actions depending on the domain status:
Domain Status | Actions |
---|---|
Active |
|
Pending Registration |
|
Pending Transfer |
|
For example, if you are using eNom and have 150 Active and Pending Registration domains and 20 domains in the Pending Transfer status, the script will check the 20 Pending Transfer status domains during each run, along with 50 of the Active and Pending Registration status domains, starting over once it reaches the newest domain.
- After the domain sync is complete, the system sends an email to admins who have the System Emails administrator role.
- If you have enabled Domain Sync Notify Only at Configuration () > System Settings > Automation Settings, the system will not perform any of the above actions. Instead, it will only send the email, which will list the changes that the sync task would have made.
Common Errors
You may see the following common errors when this task runs:
Error | Description | Recommended Solution |
---|---|---|
Sync not supported by module | This error indicates that the registrar module for this domain does not support the domain sync feature. Because of this, the system will not make any changes to this domain or its status. Typically, this error occurs when using third-party or custom domain modules. | Contact your module’s developer to fix this issue. |
Curl error - could not connect to host | This error indicates that you have not correctly whitelisted your server’s IP address for API access with your domain registrar. | Check your domain registrar module’s documentation for steps or contact the registrar and provide the IP address that appears at Help () > License Information. |
Last modified: October 9, 2024