Currency configuration

Before setting up individual currency rates, you must first set the scope of the base currency. It is set to global by default, which applies the base currency setting to the entire store hierarchy. If you have a multisite Adobe Commerce or Magento Open Source installation, you can manage multiple base currencies by setting the scope to the website level.

You also specify the currencies that you accept and which currency you want to use for the display of prices in your store. In the following diagram, the scope of the base currency is set at the website level, so each website can have a different base currency.

w-600 modal-image
Currency scope diagram

Step 1: Choose the accepted currencies

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the upper-left corner, set Scope to the store view where the configuration applies.

  3. In the left panel under General, choose Currency Setup.

  4. Expand Expansion selector the Currency Options section and set the following options:

    • Base Currency — Set to the primary currency that you use for online transactions.

    • Default Display Currency — Set to the currency that you use to display pricing in the store view.

    • Allowed Currencies — Select all currencies that you accept as payment in the store view. Make sure to also select your primary currency.

      For multiple currencies, hold down the Ctrl key (PC) or the Command key (Mac) and click each option.

    img-md
    w-600 modal-image
    General configuration - currency options

    For a detailed description of each of these configuration settings, see Currency Options in the Configuration Reference Guide.

  5. When prompted to refresh the cache, click Close Close box ) in the upper-right corner of the system message.

    You can refresh the cache later.

  6. Define the scope of the base currency:

    • In the left panel, expand Catalog and choose Catalog underneath.

    • Scroll down and expand Expansion selector the Price section. (This section only appears if the scope is set as Store View: Default config.)

    • Set Catalog Price Scope to either Global or Website.

    img-md
    w-600 modal-image
    Catalog configuration - price options

Step 2: Configure the import connection

  1. Scroll to the top of the page.

  2. In the left panel, expand General and choose Currency Setup.

  3. Configure your currency service connection:

    There are three service options: Fixer.io (legacy), Fixer Api (APILayer), and Currency Converter API

    note important
    IMPORTANT
    Starting with the 2.4.6 release, the Fixer.io service is deprecated and replaced with the Fixer API (APILayer) service. It is highly recommended that you use an APILayer account instead of a deprecated Fixer.io account.
    • To connect to the fixer.io service:

      • Expand Expansion selector the Fixer.io section.

      • Enter your fixer.io API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.

      img-md
      w-600 modal-image
      General configuration - currency setup - Fixer.io options
    • To connect to the Fixer Api (APILayer) service:

      • Expand Expansion selector the Fixer Api (APILayer) section.

      • Enter your APILayer API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.

      img-md
      w-600 modal-image
      General configuration - currency setup - Fixer API (APILayer) options
    • To connect to the Currency Convertor API service:

      • Expand Expansion selector the Currency Convertor API section.

      • Enter your Currency Convertor API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.

      img-md
      w-600 modal-image
      General configuration - currency setup - Currency Converter API options

Step 3: Configure the scheduled import settings

  1. Continuing with Currency Setup, expand Expansion selector the Scheduled Import Settings section.

    img-md
    w-600 modal-image
    General configuration - currency scheduled import settings
  2. To automatically update currency rates, set Enabled to Yes.

  3. Set the update options:

    • Service — Set to the rate provider. The default value is Fixer.io (legacy).

    • Start Time — Set to the hour, minute, and second that the rates are updated according to the schedule.

    • Frequency — To determine how often the rates are updated, set to one of the following:

      • Daily
      • Weekly
      • Monthly
    • Error Email Recipient — Enter the email address of the person who is to receive email notification if an error occurs during the import process.

      To enter multiple email addresses, separate each with a comma.

    • Error Email Sender — Set to the store contact that appears as the sender of the error notification.

    • Error Email Template — Set to the email template used for the error notification.

  4. When complete, click Save Config.

  5. When prompted to update the cache, click the Cache Management link and refresh the invalid cache.

    img-md
    w-600 modal-image
    System message - refresh the invalid cache

Step 4: Update the currency rates

The currency rates must be updated with the current values before they go into effect. Update the rates manually or to import the rates automatically.

Step 5: Customize currency symbols (optional)

Managing Currency Symbols gives you the ability to customize the symbol associated with each currency that is accepted as payment in your store.

w-600 modal-image
Currency symbols
  1. On the Admin sidebar, go to Stores > Currency > Currency Symbols.

    Each currency that is enabled for your store appears in the Currency list.

  2. Change settings in the list as needed:

    • Enter a custom symbol for each currency that you want to use, or select the Use Standard checkbox for each currency.

    • To override the default symbol, clear the Use Standard checkbox and enter the symbol that you want to use.

    note note
    NOTE
    It is not possible to change the alignment of the currency symbol from left to right.
  3. When complete, click Save Currency Symbols.

  4. When prompted to update the cache, click the Cache Management link and refresh any invalid cache.

recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1