Keystone Documentation

Appearance

Currency Detection ​

How the App Picks a Currency for Each Customer ​

When a customer visits your storefront, the app works through the following steps to decide which currency to show:

  1. Saved preference — If the customer visited before and a currency was already detected and saved for them, that currency is used again.
  2. Location — If there is no saved preference, the app looks at the customer's country (from their IP address) and selects the matching currency. For example, a visitor from Canada automatically gets CAD.
  3. Your store default — If the detected currency is not in your enabled currencies list, or if location cannot be determined, the app falls back to your store's base currency.

Once a currency is detected for a customer, it is saved so they get the same experience on future visits. No customer action is required at any point.