> 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/technical-details.md). # Technical Details This page covers the technical details for the ESW country selector and retailer-managed country selectors in Light Touch Integration (LTI). ### ESW country selector The ESW country selector is a dropdown that lists the countries available on your storefront. It can include both: * Retailer-managed countries that use your native checkout * ESW-managed countries where ESW manages pricing and checkout ### How ESW places the selector ESW configures the selector placement using CSS selectors for the desktop and mobile storefront layouts. Supported insert options: * Replace * Before * After Supported positioning options: * Left * Center * Right A CSS selector is the pattern used to target the HTML element where ESW inserts the selector. ### Styling options You can customize the selector styling to match your brand. This is handled as part of the LTI configuration. ### Retailer-managed country selector LTI also supports your own country selector with retailer-managed logic. This option is useful when your storefront already has a selector and you want LTI to read that selection instead of showing the ESW selector. ### Key behavior differences The retailer-managed selector can support multiple currencies for the same country. The ESW selector supports one configured country-currency pair per country. ### Cookie requirements If you use your own selector, LTI must receive the selected shipping country and currency from your storefront. To do this, your storefront must set cookies that LTI can read. You can choose the cookie names for both values. Your selector must create and update those cookies in the format required by LTI. Required formats: * **Country cookie**: 2-letter country ISO code in ISO 3166 format, such as `CA`, `IE`, or `GB` * **Currency cookie**: 3-letter currency ISO code in ISO 4217 format, such as `CAD`, `EUR`, or `GBP` {% hint style="info" %} Keep the country and currency values aligned with your ESW configuration. If the cookie values do not match the configured country-currency pairs, pricing or checkout behavior may be incorrect. {% endhint %} For more detail on selector configuration, contact your ESW point of contact. --- # 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/technical-details.md?ask=&goal= ``` `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.