# 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 Language Selector app block using **section groups**.

To add the Language 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/43b5a7447c6d440c95239b874e781f8d?sid=d9e92db3-4850-4d9b-8986-86439ebdb4b5>" %}

{% 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: [#update-your-theme-to-be-compatible-with-app-blocks](https://help.orbe.app/geolocation-button/how-it-works#update-your-theme-to-be-compatible-with-app-blocks "mention")
{% endhint %}

## How to setup

The **Language Selector** lets your customers manually choose their preferred language, giving them full control over how they navigate your store. You can place it wherever it best fits your design and user flow.

To ensure the Language Selector works properly, make sure it’s correctly enabled in your theme settings. If it’s not active, the selector won’t appear as expected.

Below, you’ll also find a short video tutorial that walks you through the setup step by step.

{% embed url="<https://www.loom.com/share/938cf541738c465182a9bf77fca07f7f?sid=8353463c-2821-4962-b811-df2aef3999d3>" %}


---

# 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/language-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.