# Magento 2 Custom Currency Manager
### Installation and User Guide for Magento 2 Custom Currency Manager Extension
**Table of Contents**
1. [*Installation* ](#bkmrk-installation)
- *Installation via app/code*
- *Installation via Composer*
2. [*Configuration Settings for Custom Currency Manager*](#bkmrk-configuration-settin)
- *General Settings*
3. [*Custom Currency Manager*](#bkmrk-custom-currency-mana)
4. *[Error Message When Adding Duplicate currency in Configuration settings](#bkmrk-error-message-when-a)*
5. *[Error for Deleting Currency for Configuration settings](#bkmrk-error-for-deleting-c)*
6. *[Frontend Screenshots](#bkmrk-frontend-screenhots)*
### Installation
- **Installation via app/code:** Upload the content of the module to your root folder. This will not overwrite the existing Magento folder or files, only the new contents will be added. After the successful upload of the package, run below commands on Magento 2 root directory.
```php
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
```
- **Installation via Composer:** Please follow the guide provided in the below link to complete the installation via composer.
[https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer](https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer)
### Configuration Settings for Custom Currency Manager
Go to **Admin > Stores > Configuration > Scommerce Configuration > Custom Currency Manager**
#### General Settings
- **Enabled –** Select "Yes" or "No" to enable or disable the module.
- **License Key –** Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at .
- **Custom Currencies -** Please add the defined list of custom currencies.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/kK6image.png)
#### **Custom Currency Manager**
As a customer using the Custom Currency Manager extension, you can create and configure various custom currencies such as BTC, ZWG, and others to suit your store's needs.
To add a Custom Currency like **BTC** add from **Configuration, path - Admin > Stores > Configuration > Custom Currency Manager**
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/TD3image.png)
Once you configure custom currencies by adding the currency code, symbol, plural name, and precision in the configuration, the newly added currency appears in the "Allowed Currencies" dropdown under Magento’s default currency setup section.
To configure your store’s currency settings, go to **Admin Panel > Stores > Configuration > General > Currency Setup**, where you can choose the base currency, default display currency, and allowed currencies. Please refer to the screenshots below for visual guidance on setting up custom currencies.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/DCIimage.png)
To configure currency rates for your store:
1. Go to **Admin Panel > Stores > Configuration > Currency Rates**.
2. From this section, you can manually set exchange rates or import them from supported services.
3. Make sure to save your changes to apply the updated rates across your storefront.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/image-2025-10-15t193428-520.png)
##### **Error Message When Adding Duplicate Currency in Configuration Settings**
Since GBP already exists in the default Magento, you cannot add it again. Attempting to do so will trigger a warning message.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/yIzimage.png)
##### **Error for Deleting Currency for configuration settings**
The '**Test**' currency has been selected in the Allowed Currency list for the UK site, Default Configuration, and Default Store View.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/G0mimage.png)
#### **Frontend Screenhots**
**Currency Options available on the frontend - Default store view.**
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/gadimage.png)
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/eJUimage.png)
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-10/mJwimage.png)
If you have a question related to this extension please check out our [**FAQ Section**](https://www.scommerce-mage.com/magento-2-custom-currency-manager.html#customfaq) first. If you can't find the answer you are looking for then please contact [**support@scommerce-mage.com**](mailto:core@scommerce-mage.com)**.**