> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/light-touch-integration/features/country-selector.md).

# Country Selector

ESW Light Touch Integration (LTI) includes a country selector that geolocates the shopper and sets the shipping country and currency. Shoppers can change this selection at any time from the header.

### ESW countries

An **ESW country** is a country managed through ESW systems. Countries you manage yourself are not ESW countries.

For example, if Ireland is configured as an ESW country and the shopper selects it:

* Pricing is converted to the configured currency, such as EUR.
* ESW checkout loads with ESW pricing and calculations.
* The returns portal also uses the ESW country configuration.

Each ESW country has a predefined currency set during onboarding. If you need a different currency for an ESW country, contact your ESW point of contact.

### Custom countries

You may already ship to some countries without ESW and still want to use a single storefront. In that case, you can combine ESW countries and custom countries on the same domain.

To support this, LTI lets you configure **custom countries**. When a shopper selects a custom country, ESW features do not apply for that country and your standard storefront behavior is used instead.

<div data-with-frame="true"><figure><img src="/files/QlRFOEuMCfkVG8uVLESX" alt=""><figcaption></figcaption></figure></div>

In the example above, Italy is configured as a custom country. No currency is shown because ESW does not manage currency or pricing conversion for custom countries.

When a shopper selects a custom country:

* No ESW pricing conversion is applied.
* Your standard checkout flow is used.
* Payment is processed through your non-ESW checkout.

ESW can also support multiple websites and configure a `RedirectUrl` by country. This lets you redirect shoppers to another site for selected countries. Contact your ESW point of contact for details.

### Default country

The country selector uses a default country when geolocation fails, the detected country is not supported, or another exception occurs.

For example, a shopper visits from Uruguay, but Uruguay is not in your configured country list. If Australia is your default country, Australia is selected automatically. The shopper can then change it in the country selector.

### Retailer country selector

You can keep your existing country selector and modal instead of using the ESW selector. To do this, configure the country and currency cookies during onboarding.

In this setup, LTI reads the selected country and currency pair from those cookies. The configured LTI features then use that value.

If the selected country and currency pair is not supported in your ESW Pricing Advisor configuration, pricing may not update correctly. Orders may also fail or show incorrect prices.

Whether you use the ESW selector or your own, ESW countries and custom countries must stay aligned in the LTI configuration. If your configuration and ESW configuration drift out of sync, country selection behavior may become inconsistent.

### Country selector styling

You can style the ESW country selector button and modal in **ESW Service Portal > LTI**. This lets you match your storefront design while keeping the standard LTI behavior.

You can customize elements such as size, background, font, and color.

### Supported LTI platforms

This feature is available on:

* BigCommerce
* WooCommerce
* Commerce Tools
* Web Platform
* Callback API


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/light-touch-integration/features/country-selector.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.