Learn WHMCS

WHMCS is the top web host billing and support automation tool used by thousands of customers across the globe!

• Last Updated: 05/13/2024
• ( 11 minutes reading )

How to manage currencies in WHMCS

Introduction

Currencies are monetary units people accept widely as a form of exchange within a particular country or region for physical and online goods. In simple terms, it is the money (bills, coins, and cards) we use daily to purchase goods and services from one another. Currencies are issued and regulated by central banks or monetary authorities of a country or a group of countries, such as the European Central Bank for the EUR and the Federal Reserve for the US dollar.

 

To allow people from around the globe to develop their own web hosting business, WHMCS includes a huge variety of currencies. You can manage each of these currencies and set them as the default currency of the application to enable users to choose their desired currency when paying for your web hosting services. 

 

In this tutorial, we will explain the processes of managing your currencies and how to configure the default WHMCS currency.

 

Let's begin.

Getting Started

To manage your currencies in WHMCS, log in to your admin area. After logging in, please hover your mouse cursor over the wrench icon on the top right side of the screen. Doing so will reveal a drop-down menu. Please select the "System Settings" option.

 

system-settings

 

Doing so will redirect you to the "System Settings" page, where you will see many available configurations WHMCS allows you to perform. 

 

find-currencies

 

Using the search bar on the left side of the screen, please type in "Currencies". Fulfilling this action will reveal the "Currencies" option in the middle of the screen. Please click on it to be redirected to the currencies management page.

 

currencies-page

 

On the top of the page, you will see all the available currencies in a table section. WHMCS will have the USD currency configured as the base currency by default. You will see a pencil icon on the top right column of the table section. 

 

Please click on it to edit your base currency.

 

Managing the default currency

 

After being redirected to the currency editing page, you will find a few options that allow you to do so. 

 

manage-base-currency

 

Let us go over them so you can get a better understanding.

 

  • Currency Code - Please use this text field to change the respective currency's currency code. For example, USD is for the dollar, and GBP is for the British pound. You may find all available currency codes here.
  • Prefix - Please use this text field here to change the prefix for your base currency. The prefix is the symbol that will show before the currency itself. For example, you may add "$" for the dollar, "" for the Euro, and "£" for the British pound.
  • Suffix - Please use this text field here to change the suffix for your default currency. The suffix is the symbol/abbreviation that will show after the currency itself. For example, you may add "USD" for the dollar, "EUR" for the Euro, and "GBP" for the British pound.
  • Format - Please use this drop-down menu to select the format of your default currency. You have a few options here, so please choose the one you prefer.
  • Base Conv. Rate - When editing the conversion rate of the base currency for WHMCS, this option will always be greyed out, and you may not edit it. It will show the rate at which this currency goes against the default currency (in this case, when you edit the base currency, it will go against itself, so the value will be 1). When you are adding new ones, you can add different values. For example, the conversion rate of the EUR against the USD can be 1.2.
  • Update Pricing - Please use this checkbox to automatically re-calculate the pricing of your hosting plans for the default currency when you add it.

 

When you finish editing the base currency, please click the "Save Changes" button underneath the setting.

 

Adding New Currencies

 

WHMCS will also let you support different types of currencies if you, for example, want to sell to your customers from Europe in EUR and sell to your customers in the United States in UID. To add a new currency, please use the form underneath the table section containing all the present currencies.

 

add-additional-currency

 

Similarly to the earlier options that allow you to edit it, you will have the following:

 

  • Currency Code - Please use this text field to add a code for the new currency. For example, USD can be used for the dollar and GBP for the British pound. You may find all available currency codes here.
  • Prefix - Please use this text field here to change the prefix for the newly added currency. The prefix is the symbol that will show before the currency itself. For example, you may add "$" for the dollar, "" for the Euro, and "£" for the British pound.
  • Suffix - Please use this text field here to change the suffix for your new currency. The suffix is the symbol/abbreviation that will show after the currency itself. For example, you may add "USD" for the dollar, "EUR" for the Euro, and "GBP" for the British pound.
  • Format - Please use this drop-down menu to select the format of your new currency. You have a few options here, so please choose the one you prefer.
  • Base Conv. Rate - When editing the conversion rate of the base currency for WHMCS, this option will always be greyed out, and you may not edit it. However, when you add new ones, you can set a conversation rate against it. For example, the conversion rate of the EUR against the USD can be set to 1.2.

 

After setting up the new currency, please click the "Add Currency" button at the bottom of the form.

 

After doing so, the page will refresh, and you will see your new currency inside the table section we reviewed earlier in this tutorial.

 

Since you may be using multiple currencies and going over all of them and their conversion rates could be tedious, WHMCS includes two buttons that will make your life easier. 

 

update-rates-and-price-buttons

 

These are the "Update Exchange Rates" and "Update Product Pricing" buttons located directly underneath the table section.

 

  • Update Exchange Rates - Please click this button to automatically update the exchange rate of all the new currencies against your base one.
  • Update Product Pricing - Please click this button to automatically update the product pricing, which uses the specific currency to match the price in the base one. For example, if one hosting plan costs $5 in USD, it may cost £4,02 in GBP.

 

After clicking either of these buttons, the page will quickly refresh, and you will see the desired value update.

Conclusion

This wraps up our tutorial covering the currency management of your WHMCS. We hope you found it helpful and clarified any uncertainties you had before reading it. If you liked what you read, please be sure to check the rest of our tutorials in our WHMCS tutorial series.

...
Nikola Zgurev
Technical Support Captain

Nikola is an accomplished tech-savvy extraordinaire with over six years of experience in the web hosting field. He started as a customer care representative and quickly rose the ranks to become a support supervisor and, eventually - the head of the technical department in HostArmada. His deep understanding of the client's needs, combined with his technical knowledge, makes him the perfect man to create the ideal harmony between client satisfaction and professional problem-solving. You will often find him creating helpful tutorials, articles, and blog posts that help existing customers get around.