Set Up Your Store

Once the Reach Localize App is installed on your store, use the information on this page to help you guide you through the setup.

Here's an overview of what you'll need to do to set up your store:

1. Update your currency settings in Shopify
2. Verify that the update took effect by looking at the "Money" attribute in your code
3. Add the Reach Checkout additional script
4. Embed the Reach Localize Script within your store

That's it!

You can optimize your Reach Script further using some of the attributes available.

Currency Settings

Change the store currency formatting in your Shopify admin settings.

Update the "span" tag from to .

Here's an example:

🚧

To be safe, ensure the use of quotes or other symbols '<${" etc. doesn't affect the current theme by making this change then checking a preview of your theme for any console errors.

Verify Money Tags

Verify that the update you did in the "span" class in the last step has taken effect. Do this by double checking in your code that all money values are rendered with the | money filter.

Here's an example that shows | money is correctly showing up in the code.

<span>{{ product.price | money }}</span>

To make sure that the price conversions are done correctly, the class=money must be within every that involves a price that needs to be converted on your store.

Reach Checkout Additional Scripts

Add snippet to Settings > Checkout > Additional Scripts

<script>
  // Required for Reach Gateway
  var gip_order_id = '{{ checkout.order_id }}';
</script>

Embed the Reach Script in theme.liquid and checkout.liquid

We recommend creating a snippet called reach-script.liquid with the script configuration below and include it in theme.liquid and checkout.liquid, at the very end of .

To find the code most relevant to your store, please visit My Shop's Custom Code.

<!-- Reach Localize Script -->
<script
   id="gointerpay_localize"
   src="https://assets.rch.io/{Merchant Id}/localize.js"
   data-merchant_id="{Merchant Id}">
</script>

{% include 'reach-script' %}

Script Tag Options

To further customize your shop's code, you can use the attributes described below.

Gateway Codes:

Environments:

Javascript Helper Methods

GIP.getLocalizeData().then(function (data) {
    if (data) {
        console.log(data);
    } else {
        console.log('No rate offer available.');
    }
});

Uninstall conflicting apps from your store

❗️

Uninstall conflicting apps from your store

Reach Localize is powerful but not powerful enough to work accurately when there are conflicting apps already installed in your store. If you have apps that fall under the categories below, kindly uninstall them or stop them before completing your Reach Localize customization.

1. All currency customization apps installed on your store
2. Any Geo location apps
3. Shopify Multi Currency