Theme and script support for selling in multiple currencies

Customize your storefront and create scripts to support selling in multiple currencies.

Currency selection

After you've enable selling in multiple currencies with Shopify Payments, your customers can check out in their local currency. The currency that your customers see in your store can be set in a few ways:

  • Link - You can send your customers a URL that will open your store in a specific currency.

    You can also send your customers a URL that will open your store in a specific currency to the end of your URLs, where _ISO-code_ is the 3-character ISO 4217 currency code. For example, the following link opens the store and shows all the prices in Canadian dollars: `myshopify-store.myshopify.com?currency=CAD`.

  • Currency selector - If you want your customers to choose their local currency, then you need to add a currency selector.

  • Geolocation (Shopify Plus) - Geolocation is only available on the Shopify Plus plan. When a customer visits your store, your store chooses the currency to display based on the location of your customer.

    When a customer goes to your store, your store chooses the currency to use based on the geolocation of their IP address. The prices in your storefront and checkout convert immediately to that currency. If a customer's location uses a currency that isn't supported by your store, then the store's currency is used. For example, your store currency is USD and you accept USD, EUR, and YEN. When a customer from Brazil visits your store, they see prices in USD (your store's currency) because you don't accept payments in BRL.

Theme currency selector

If you want your customers to choose their preferred currency from a dropdown list of currencies, then you can create your own currency selector in your theme.

Most themes don't include a currency selector that supports selling in multiple currencies with Shopify Payments, so you need to create one. Many themes don't include a currency selector by default. You need to add a multi-currency selector to your themes. You can use Shopify Liquid to create currency selectors in your storefront, so that your customers can choose their local currency.

Shopify scripts support

You should review your scripts to make sure that they still work as intended when you enable selling in multiple currencies. Learn about script features that support selling in multiple currencies.

API support

Learn about the API features that support selling in multiple currencies.

Learn more

Ready to start selling with Shopify?

Try it free