Domain Sync Task

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.

For more information, see System Cron and Domain Statuses.

The Domain Sync Task

The domain sync task uses each domain registrar module’s domain synchronization functions (if they exist) to sync domain information. It checks domains from the oldest to the newest in your installation.

Task Actions

The task performs the following actions depending on the domain status:

Domain StatusActionsDomains Checked Per Run
Active
  • The task will update the expiry date to match the date that the domain registrar returns for it, if the dates differ.
  • If the dates already match, the task returns an In Sync message.
  • If you have enabled Sync Next Due Date at Configuration () > System Settings > Automation Settings, it will adjust the Next Due Date value.
50
Pending Registration
  • The task will update the expiry date to match the date that the domain registrar returns for it, if the dates differ.
  • The task will also set the domain status to Active if registration is now complete.
  • If the dates already match, the task returns an In Sync message.
50
Pending Transfer
  • The task will report an error if the transfer process is not complete.
  • If the transfer process is complete, the task will:
    1. Set the domain status to Active.
    2. Send the Domain Transfer Completed email template with the expiry date from the registrar.
  • If the domain uses the eNom module and the transfer fails, the task will send the Domain Transfer Failed email template.
All

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 all of the Pending Transfer status domains and 50 each of the Active and Pending Registration status domains during each run. It will start 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.
For more information, see Domain Statuses.

Common Errors

You may see the following common errors when this task runs:

ErrorDescriptionRecommended Solution
Sync not supported by moduleThis 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 hostThis 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.
automation domain-sync

Last modified: December 11, 2024