This article covers common issues when installing, configuring, or using the WHMCS Link Compliance Module.
The Module Does Not Appear in Addon Modules
- Check that the module folder has been uploaded to
/modules/addons/. - Make sure the folder name and file structure are correct.
- Confirm that file permissions allow WHMCS to read the module files.
The Module Is Activated But I Cannot Access It
- Make sure your admin role has permission to access the module.
- Go to System Settings > Staff Management > Admin Roles.
- Edit your role and enable access to WHMCS Link Compliance Module.
Licence Status Is Not Active
If the module shows that the licence is missing, invalid, expired, or suspended:
- Go to System Settings > Addon Modules.
- Click Configure for the module.
- Check the entered License Key.
- Click Check License again.
If the licence still does not activate:
- Confirm the correct key was entered
- Check that the module can contact the licensing server
- Check your WHMCS activity log for licence-related entries
Important: If the licence is not valid, the module will not run automated checks normally.
The Module Has No Eligible Services
If the Eligible services list is empty:
- Review your scope settings in the Settings tab
- Check your configured product IDs, group IDs, server IDs, and custom field rules
- Make sure at least one scope rule matches the hosting services you expect
- Run Tools > Run sync now again after saving changes
Checks Are Not Running Automatically
If scheduled checks are not running:
- Make sure Enable daily cron processing is turned on
- Confirm your WHMCS daily automation cron is running properly
- Check that the module licence is active
- Review audit runs and logs in the module
- Look for related entries in the WHMCS activity log
Check Results Show Uncertain or Off-Platform
This usually means the module cannot confidently confirm that the website is still hosted on your platform.
Common causes include:
- Cloudflare or another proxy service is in front of the site
- The DNS no longer points directly to your server
- Your allowed server IPs or nameservers are incomplete
- The site has moved away from your hosting
To fix this:
- Review your allowed server IPs and nameserver settings
- Confirm whether the client is still hosted with you
- Do not treat off-platform results as link breaches unless you are certain of the impact
A Site Is Marked Non-Compliant But the Link Exists
If a website is being flagged incorrectly:
- Check whether the link appears only after JavaScript loads
- Check that the destination URL or hostname is listed in your approved settings
- Check that the banner substring or anchor text pattern matches what the site is using
- Review the evidence stored in the check result
You may also:
- mark the result as a false positive,
- set the service to manual compliant, or
- apply a temporary ignore or exemption if appropriate.
Client Tickets Are Not Opening
If incidents are being created but tickets are not opening:
- Confirm that Automatically open client tickets is enabled
- Check that the Ticket Department ID is valid
- Confirm your workflow thresholds have been reached
- Make sure ticketing has not been suppressed for that service or incident
- Check logs for ticket-related errors
Too Many Sites Are Being Checked or Rechecked
If checks are running more often than expected:
- Review your Batch size
- Review Minimum days between automatic checks per service
- Check whether staff are using manual check tools
- Confirm that dry-run or test batches are not being run repeatedly
The Module Was Upgraded but New Tabs or Features Are Missing
If the module was updated and parts of the admin area are missing or not working as expected:
- Go to System Settings > Addon Modules
- Find WHMCS Link Compliance Module
- Click Upgrade if it is available
This ensures that any required database updates are applied before the newer features are used.
Useful Checks
- Run Tools > Run sync now after changing scope settings
- Use Check now on one service before enabling full automation
- Use Dry run during initial testing
- Review the module logs and WHMCS activity log together when diagnosing issues
Still Need Help?
If the issue continues after checking the above:
- note the exact error or unexpected behaviour,
- record whether it occurs during manual checks, cron runs, or ticket actions,
- and gather screenshots of the relevant module tab, settings, and logs before contacting support.