Multi-Currency Code Install Instructions

Warning!

Any other currency conversion apps or software should be disabled on your site before using Multi-Currency. Using two conversion apps at the same time can cause conflicts with how the currency displays on the site.

Before you begin, please review Notes Before Installing Apps. This article will help get you prepared and answers many common questions.

Note: This article requires technical knowledge and prior experience with liquid code. If you are not comfortable with this, please complete Step 1 of this guide, then visit Request a Multi-Currency Installation for additional assistance.

Select each step below to view the instructions.

  1. From Shopify's admin, select Settings.

    select settings

  2. Select General.

    select general

  3. Under "Store currency", select Change formatting.

    Select Change Formatting

  4. Replace the HTML with currency code with:

    Note: The currency symbol and abbreviation should match your store's currency. If you're using the Japanese Yen as your default currency, please use {{amount_no_decimals}} for your currency formatting.

    <span class=money>${{amount}} USD</span>

    replace the HTML with currency code

  5. Replace the HTML without currency code with:

    Note: The currency symbol should match your store's currency.

    <span class=money>${{amount}}</span>

    replace the HTML without currency code

  6. Select Save.

     

  1. Duplicate themes, to create a backup copy.
  2. From Shopify's admin, select Online Store.

    select online store

  3. Select Actions.

    select actions

  4. Select Edit code.

    select edit code

  5. Under "Snippets", find bold-common.liquid.

    Find bold-common

    1. If it doesn't exist, select Add a new snippet.

      Select Add New Snippet

    2. Enter the correct snippet name.

      Enter Snippet Name

    3. Select Create snippet.

      Select Create Snippet

    4. Copy and paste the bold-common.liquid code.

      Paste bold-common code

    5. Select Save.

       

To add the liquid files to your current theme, please follow these steps:

  1. From Shopify's admin, select Online Store.

    select online store

  2. Select Actions.

    select actions

  3. Select Edit code.

    select edit code

  4. Under "Assets", find these files:
    • flags.min.css
    • bold-currency-picker.css
    • bold-currency-bootstrap.js
  5. For any that don't exist:
    1. Select Add a new asset.

      select add new asset

    2. Select Create a blank file.

      create blank file

    3. Enter the correct asset name in the "Create a blank file called" field.

      select asset name

    4. Select the correct extension (i.e. css or js).

      select correct extension

    5. Select Add asset.

      select add asset

    6. Copy and paste the code found in each of these links into their respective files:

      picture of code

    7. Select Save.

       

    8. Repeat Steps 5.1 - 5.7 for each missing snippet file.
  6. Under "Snippets", find these files:
    • bold-currency-converter.liquid
    • bold-currency-picker-mount.liquid
    • bold-currency-templates.liquid

    find these files

  7. For any that don't exist:
    1. select Add a new snippet.

      select add new snippet

    2. Enter the correct snippet name in the "Create a new snippet called" field.

      enter in the snippet name

    3. Select Create snippet.

      select create snippet

    4. Copy and paste the code found in each of these links into their respective files:

      picture of the code

    5. Select Save.

       

    6. Repeat Steps 7.1 - 7.5 for each missing snippet file.
  1. From Shopify's admin, select Online Store.

    select online store

  2. Select Actions.

    Actions

  3. Select Edit code.

    Edit code

  4. Under "Layout", select theme.liquid.

    Select theme.liquid

  5. Copy and paste this code directly above the </head> tag.
    {%- render 'bold-common' -%}

    Paste render bold common

  6. Copy and paste this code directly above the </body> tag.

    {%- render 'bold-currency-converter' -%}

    Paste render currency converter

  7. Copy and paste this code where you would like the currency picker widget to appear (optional):

    Note: The purpose of this code is to add the currency picker in more that one location (i.e. header, footer, etc.). If you don't complete this step, Multi-Currency will automatically add one for you which will appear at the bottom center of the viewport. If you do complete this step, the app will not automatically add one. openDirection: 'up' causes the picker to open upwards, this can be changed to down if you prefer.

    {%- render 'bold-currency-picker-mount', openDirection: 'up' -%}

    Paste render picker mount

  8. Select Save.

     

  1. From Shopify's admin, select Online Store.

    Select Online Store

  2. Select Actions.

    Select Actions

  3. Select Edit code.

    Select Edit Code

  4. Under "Templates", select cart.liquid.

    Note: This may be located under "Sections" in the cart-template.liquid file.

    Select cart.liquid

  5. Find a line of code similar to:
    {{ item.price | money }}
    On newer themes, it may be:
    {{ item.final_price | money }}

    Note: This code may be referenced differently depending on the theme you are using. In some themes, this code may not exist at all. If it is contained within your theme, the code will include a reference to "price".

    Find item.price money
  6. Copy and paste the following snippet of code above this line:
    <span class="Bold-theme-hook-DO-NOT-DELETE bold_cart_item_price" style="display:none !important;"></span>

    Copy/Paste Bold Code

  7. Find a line of code similar to:
    {{ item.line_price | money }}
    On newer themes, it may be:
    {{ item.final_line_price | money }}
    Find item.line price money
  8. Copy and paste the following snippet of code above this line:
    <span class="Bold-theme-hook-DO-NOT-DELETE bold_cart_item_total" style="display:none !important;"></span>

    Copy/Paste Bold Code

  9. Find a line of code similar to:
    {{ cart.total_price | money }}

    Find cart.total_price money

  10. Copy and paste the following snippet of code above this line:
    <span class="Bold-theme-hook-DO-NOT-DELETE bold_cart_total" style="display:none !important;"></span>

    Copy/Paste Bold Code

  11. Select Save.

     

That's it!

Next Steps:

Blog Posts:

Was this article helpful?
29 out of 39 found this helpful