> For the complete documentation index, see [llms.txt](https://help.orbe.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orbe.app/selectors/country-selector/how-it-works.md). # How it works ## How to add If you have a newer Shopify theme compatible with app blocks (any public theme version [after March 2023](https://shopify.dev/changelog/we-are-introducing-sections-liquid-tag-and-section-groups)), you can add the Country Selector app block using **section groups**. To add the Country Selector, go to the **Shopify Theme Editor**, navigate to your desired section, and insert the app block directly. {% embed url="" %} {% hint style="warning" %} Many themes are not compatible with adding **app blocks** in a section that appears in all your theme pages (like the **header** or the **footer** sections). If that is your case, follow this tutorial: [How it works](/selectors/geolocation-button/how-it-works.md#update-your-theme-to-be-compatible-with-app-blocks) {% endhint %} ## How to setup The **Country Selector** lets your customers manually choose their preferred country, giving them full control over their shopping experience. You can place it in the area of your store that works best for your design and user flow. To make sure the Country Selector works properly, you’ll need to check that it’s correctly enabled in your theme settings. If it’s not active, the selector won’t display as expected. Below, you’ll also find a short video tutorial showing exactly how to set it up step by step. {% embed url="" %} --- # 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://help.orbe.app/selectors/country-selector/how-it-works.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.