# 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 Geolocation Button app block directly to your header or footer using **section groups**. To add the Geolocation Button, go to the **Shopify Theme Editor**, navigate to your desired section (header or footer), and insert the app block directly. {% embed url="" %} However, 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** {% embed url="" %} Here’s how to do it: 1. **Edit your theme:** Go to **Online Store > Themes > Edit code** in your Shopify admin. 2. **Check your sections folder.** Look for a section in this folder called `apps.liquid`. If it does not exist, create the file and insert this code: ```liquid

{%- for block in section.blocks -%} {% render block %} {%- endfor -%}

{% schema %} { "name": "Apps", "tag": "section", "blocks": [ { "type": "@app" } ], "presets": [ { "name": "Apps" } ] } {% endschema %} ``` 3. **Create a new file.** Insert a new file in the `sections` folder with the name: `app-group.json`. And insert this code: ```json { "type": "aside", "name": "Apps", "sections": { "main": { "type": "apps", "settings": { } } }, "order": [ "main" ] } ``` 4. **Edit theme.liquid.** Go the theme.liquid file and insert this after closing the `` tag or after the section `header` / section `footer`. ```liquid {% sections 'app-group' %} ``` 5. **Theme Editor.** Click on "Customize" your theme, and you will see a new section called `Apps` only for adding app blocks to your installed apps. ### Your section is not supported in a section group

If you see a message like **“Section xxx is not supported in section groups”** when trying to add an app block to the header or footer, this is a **theme limitation**. Some themes disable app sections in certain groups using the `disabled_on` property in the section schema. When `header` or `footer` are included, Shopify won’t allow the app block to be added there. Example of code that causes this issue: ```json "disabled_on": { "groups": ["header", "footer"] } ``` #### How to fix it Edit the section code in your theme and remove the `disabled_on` property from the schema.\ After saving the changes, the app block can be added to the header or footer normally. ## How to setup ### Enable the correct App Embed The **Geolocation Button** can open either the **Geolocation Popup** or the **Market Selector modal**. To ensure the Geolocation Button works properly, you need to enable the correct app embed based on your selected option. Otherwise, the button will not function as expected. Follow these steps to set it up: * If you choose the **Geolocation Popup**, make sure the `Geolocation Popup` app embed is enabled. * If you select the **Market Selector modal**, ensure the [`Market Selector`](https://help.orbe.app/market-selector#modal-selector) app embed is enabled with the **Modal** option selected. This setup is essential for the button to display the correct selector when clicked. {% embed url="" %} ## Learn more about


Selector Placement	Learn how to position your selector exactly where you want in your theme.	selector-position.png	selector-placement
Enable the Market Modal	Learn how to customize the modal selector to combine it with the Geolocation Button	modal-selector-2.gif	#modal-selector