View source for Customising Countries and Calling Codes

<div class="docs-alert-info">
<i class="fa fa-question-circle"></i> 
This page describes a feature available in version 7.0 and above.
</div>
 
==What is the Countries File?==
 
The <tt>countries.json</tt> files determines the countries that appear within WHMCS and their respective calling codes.
 
Primarily, WHMCS uses these lists of country data to determine the contents of the country menu choices for addresses and county call codes. They only have a limited affect on [[Phone_Numbers#Automatic_Number_Formatting|automatic phone number formatting]].
 
==Customising Countries==
 
The default country definitions that ship with WHMCS are in <tt>resources/country/dist.countries.json</tt>. Do '''not''' edit this file.
 
<div class="docs-alert-info">
<i class="fa fa-question-circle"></i> 
<span class="title">WHMCS 6.9 and earlier</span><br />
Prior to WHMCS 7.0, this file was located at <tt>/includes/countries.php</tt> in a different format.
</div>
 
To customise the list of countries, begin by creating a custom <tt>countries.json</tt> file in the <tt>/resources/country/</tt> directory.
 
===ISO-3116 Countries===
 
If you add non-ISO-3166 countries, WHMCS adds them to: 
 
* The country menu selections for addresses.
* The country codes used for backend phone parsing.
* The repository that [[Phone_Numbers#Automatic_Number_Formatting|automatic phone number formatting]] uses to format phone numbers. 
 
Removing or changing a country or calling code will '''not''' alter the default ISO-3166 repository that WHMCS uses for [[Phone_Numbers#Automatic_Number_Formatting|automatic phone number formatting]]. Changes and removals are limited to the address country menu choices and the backend phone number formatting logic that WHMCS transmits to external service providers like registrars or gateways.
 
===Adding a Country===
 
Inside your custom <tt>/resources/country/countries.json</tt> file, add a section that resembles this example:
 
<source lang="yaml">
{
    "ABC": {
        "name": "Awesome Best Country",
        "callingCode": 12345
    }
}
</source>
 
This will add a country with the display name <tt>Awesome Best Country</tt>.
 
===Modifying a Country===
 
Inside your custom <tt>/resources/country/countries.json</tt> file, add a section that resembles this example:
 
<source lang="yaml">
{
    "GB": {
        "name": "Great Britain",
        "callingCode": 44
    }
}
</source>
 
The above example would customise the display name for United Kingdom (GB) to <tt>Great Britain</tt>.
 
===Removing a Country===
 
Inside your custom <tt>/resources/country/countries.json</tt> file, add a section that resembles this example:
 
<source lang="yaml">
{
    "GB": false
}
</source>
 
The above example would remove GB (United Kingdom) from the available countries within WHMCS.
 
==Troubleshooting==
 
If, after making an edit to your custom <tt>/resources/country/countries.json</tt> file, it does not take effect, this indicates that the file contains invalid syntax. The file must contain valid JSON syntax. Running the contents of your file through [http://www.jsonlint.com/ an online syntax validation checker] can help you find any issues.
No results found.