# 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="<https://www.loom.com/share/2d978197aa594734848eaad5559957dd?sid=302e30fa-b413-4e1c-9546-e455f98fb593>" %}

{% 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="<https://www.loom.com/share/fa633c94a44c497c8ec2511519b9b8d5?sid=137af32f-729f-43f9-952a-d19a9e5dbb28>" %}


---

# Agent Instructions: 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:

```
GET https://help.orbe.app/selectors/country-selector/how-it-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.