Currencies
Last updated
Was this helpful?
English
Last updated
Was this helpful?
PrestaShop supports a large number of currencies. By default, only one currency is registered for your store, i.e. the currency of your store’s default country. However, you can add and configure new currencies to better meet your customers’ needs. Indeed, customers will appreciate being able to shop in their own currency!
All the exchange rates of the added currencies (official or alternative) are calculated from one unit of your store's default currency. That's why the default currency should be the currency in which you are most comfortable.
To change the default currency of your store:
Go to the International > Localization page
See the ‘Default currency’ feature in the Configuration section
Select the currency you want to set as default
If the currency you want to set as default is not available, you must add it whether by importing the localization pack of a country using this currency or by completing the “Add a new currency” form (See “Adding a new currency”).
There are two ways of adding a new currency:
This can be done in the "Localization" page of the "International" menu.
For example, if you want to add the Algerian Dinar, you can import Algeria’s localization pack.
When importing a localization pack, the language and the currency will be enabled by default. Once imported, you can manage the status of the currency on the “Currencies'' page.
Click on the "Add a currency" button. Select the currency you want to add from the list. The fields will be filled in automatically.
By default, the currency is disabled. To activate it in your store, do not forget to switch the Status button to “Yes” and save.
You may need to add a currency that is not included in any of the localization packs or that is not available in the list of currencies. Use this feature to add any cryptocurrency, local currency, etc. that meet your customers’ needs.
Click on the “Add a new currency” button
Check the box “Create an alternative currency”
Complete the fields:
Currency name. Enter the name of the currency.
Exchange rate. This rate is to be defined according to your store's default currency. For example, if the default currency is euros and your chosen currency is dollars, type "1.20" (1€ = $1.20).
Decimals. Number of digits following the decimal point for the prices on your store.
Status. Any currency can be disabled at any time, both from the edit page, and the currencies listing on the "Currencies" page. When you create a new currency by using the “Add a new currency form”, it is disabled by default.
You can customize the format and the symbol of each currency depending on the languages of your store (both the activated and deactivated ones).
When editing a currency, at the bottom of the page, choose the language for which you want to modify the currency symbol and/or format and click on “Edit Symbol/Format”.
Enter the currency symbol and choose the format:
just in front of the amount, e.g. □999.99
in front with a space between the symbol and the amount, e.g. □ 999.99
just after the amount, e.g. 999.99□
after the amount with a space between them, e.g. 999.99 □
The white square will be replaced by the currency symbol once the “Symbol” field is filled in.
Please note that this feature is only available when editing a currency.
A currency exchange rate, or conversion rate, is the rate at which one currency will be exchanged for another. For example, a conversion rate EUR/USD of 1,22 means that 1 euro equals 1,22 dollars.
If a product costs 15 euros, it will cost 18,30 dollars. (15*1,22 = 18,3)
On the contrary, if a product costs 15 dollars, it will cost 12,30 euros. (15/1,22 = 12,3)
Do not forget to regularly update the rates, by following these steps:
Clicking on the “Update” button will automatically update the exchange rates of your store’s currencies :
Go to the “Exchange rate” section of the “Currencies” page
Click on the “Update” button
Custom currencies’ exchange rates will not be updated automatically, so you will have to manually update them. For example, if you added Bitcoin and want to update the exchange rate, click on the pencil to modify the currency in the Currencies listing, and enter the exchange rate in the corresponding field. Therefore, for high volatile alternative currencies, it is highly recommended to use a module that can automatically update the currency rate.
A simple search on the internet is usually sufficient to find a currency exchange rate. There are a lot of converters online that you can use, such as XE.com:
ISO code. Enter the currency 4217 ISO code. See for more information. You will also be able to find unofficial ISO codes of alternative currencies, such as Bitcoin.
Rates on PrestaShop are provided by the ECB () and updated every day. However, note that they might slightly differ from the current ones as these rates can fluctuate greatly in a short time.
For cryptocurrencies, you can visit the following websites:
