If you trade in more than one currency, you can define the currencies you use on the Currencies list. To access this page, just select Configuration­->Currencies from the nBill menu as shown in figure 3.2

Figure 3.2 - Accessing the Currencies List

This brings up a list of the currencies that are defined on the system. By default, the component comes with 4 currencies: US Dollars, Canadian Dollars, Euros, and British Pounds. You can add your own currencies, or delete any of these if you don't use them. You don't have to delete them if you don't use them - it's up to you.

To create a new currency record, click on the 'New' toolbar button. To edit an existing currency record, you can either check the box next to the record and click on the 'Edit' toolbar button, or just click on the name of the currency. This will take you to the Currency Editor, which contains the following settings.

Basic Tab

Name of Currency

This is the full name which is used as the display name in dropdown lists elsewhere in the component.

ISO Code

All currencies have a 3-character code designated by the International Standards Organisation (ISO). Because this code is universally understood, it is used in various places by nBill - particularly on summary screens when products are being ordered online.


Most currencies also have a single-character symbol which is widely recognised within its country of use. This symbol will be used on invoices.

Technical Note: Currency symbol characters can sometimes display differently on different computers, so if the symbol you see is not correct, it might be best to try to use the appropriate HTML character code instead. See the following table for HTML character codes of the main currencies.

HTML Code Description Symbol
$ Dollar $
€ Euro
£ Pound £
¥ Yen ¥
¤ Generic International Currency Symbol ¤

The following HTML character codes provide Unicode representations of other currencies. These may or may not work but are provided here for your reference.

HTML Code Description Symbol
฿ Baht ฿
₡ Colón
₢ Cruzeiro Real
₫ Dông
₦ Naira
৳ Rupee Sign (Bengali)
৲ Rupee Mark (Bengali)
₨ Rupee
₪ Shekel
₩ Won

Advanced Tab

Override Formatting?

Whether or not to override the currency formatting options (for this currency only) that were specified on the global configuration page. If this option is set to 'no', the values from the global configuration page will be used regardless of what values are set here.

Currency Precision

Decimal places for general currency values in this currency.

Currency Line Total Precision

Decimal places for currency values in this currency that constitute a line total on an invoice. If you need finer precision that 2 decimal places for certain products, you might want to set the currency precision to a higher value, maybe 3 or 4, and have the line total rounded to 2. Or if you prefer, you can have the line totals also at the higher value and just show the grand total at 2 decimal places (or whatever is customary for your currency - for example, Japanese Yen uses 0 (zero) decimal places).

Currency Grand Total Precision

The number of decimal places to use for grand totals on an invoice. This would normally be 2, but should be whatever is customary for the currency you are using.

Thousands Separator

If you want to use a different thousands separator to the one that comes with the locale your server is running on, you can specify a custom separator here. The value 'default' (without quotes) will use whatever is the default thousands separator for the locale in use.

Decimal Separator

If you want to use a different decimal separator to the one that comes with the locale your server is running on, you can specify a custom separator here. The value 'default' (without quotes) will use whatever is the default decimal separator for the locale in use.

Currency Format String

If the above settings still don't give you enough control over how currency amounts are formatted, you can specify a custom format string here (advanced users only!). Please refer to the help text for the setting (by clicking on the life-belt icon) for more information.