Installation & Upgrade Instructions Print

  • 18

Installing the module is a straightforward process, simply follow the steps below and feel free to contact us if you need any help.

  1. Download the module from

  2. Extract the zip into your WHMCS root directory.

  3. In WHMCS, go to System Settings > Addon Modules and activate the module, making sure you grant access to your user role.

  4. Enter your License Key and Company ID provided in your welcome email into the relevant fields.

  5. Now you can connect the module to Xero by pressing "Connect to Xero" at Addons > Xero and enter configuration options by going to Addons > Xero > Configuration. When done, press Synchronise All to check that everything is working correctly. 

  6. See this article for help with linking WHMCS payments to Xero.

Please note that by enabling the Contact sync option matches WHMCS contacts with Xero by (Billing) Company Name followed by Contact Name if no Company Name is set. This will replace contact data in Xero - please do not archive WHMCS-linked contacts!

When using a web server other than Apache, you should replicate the restrictions in the modules/addons/xero/.htaccess file for security.


Upgrading to a new release is as simple as extracting the new version's files into your WHMCS root directory, allowing all files to be replaced.

Upgrading from v5 to v6

You no longer need to create an app at, please delete the app you created and reconnect the module to Xero

Upgrading from v3 to v4

Xero have deprecated the usage of OAuth 1.0a (which required the generation of a certificate file that was stored on the server and also uploaded to Xero).

When upgrading from v3 to v4 of our module, you will need to create a new App in Xero and re-connect the module to your account. Simply follow the installation instructions above from step 5 onwards. Other than the Xero ID and Secret, there will be configuration to change.

If you have a custom-hook.php file in your module folder, you will need to add the line below to the top of that file:

namespace EdgeHosting;

Was this answer helpful?

« Back