How it works

How to add

If you have a newer Shopify theme compatible with app blocks (any public theme version after March 2023), 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.

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

Here’s how to do it:

Edit your theme: Go to Online Store > Themes > Edit code in your Shopify admin.

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:

<div>
  {%- for block in section.blocks -%}
    {% render block %}
  {%- endfor -%}
</div>

{% schema %}
{
  "name": "Apps",
  "tag": "section",
  "blocks": [
    {
      "type": "@app"
    }
  ],
  "presets": [
    {
      "name": "Apps"
    }
  ]
}
{% endschema %}

Create a new file. Insert a new file in the sections folder with the name: app-group.json. And insert this code:

{
  "type": "aside",
  "name": "Apps",
  "sections": {
    "main": {
      "type": "apps",
      "settings": {
      }
    }
  },
  "order": [
    "main"
  ]
}

Edit theme.liquid. Go the theme.liquid file and insert this after closing the <body> tag or after the section header / section footer.
```
{% sections 'app-group' %}
```
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:

"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 app embed is enabled with the Modal option selected.

This setup is essential for the button to display the correct selector when clicked.

Learn more about

Selector Placement

Learn how to position your selector exactly where you want in your theme.

Enable the Market Modal

Learn how to customize the modal selector to combine it with the Geolocation Button

PreviousGeolocation Button NextSelector Placement

Last updated 9 days ago

Was this helpful?

hashtagHow to add

hashtagUpdate your theme to be compatible with App Blocks

hashtagYour section is not supported in a section group

hashtagHow to fix it

hashtagHow to setup

hashtagEnable the correct App Embed

hashtagLearn more about