# Install Orbe

Installing Orbe will only take two minutes and allow you to ensure your customers always see the right products, prices, content, currency and language, depending on their country. In this tutorial, we will describe how you can do it:

## Step 1: Search for Orbe and add app

After gaining an understanding of how Orbe works and how it can benefit your business, it's time to proceed with the installation. You can find Orbe Geolocation in the Shopify App Store by searching for it, or you can quickly access the app listing by clicking on this [link](https://apps.shopify.com/orbe?utm_source=docs\&utm_medium=content\&utm_campaign=install-orbe).

Next, simply click on "Add app":

<figure><img src="/files/hZcs1hiAu3vvNESDxS3B" alt=""><figcaption></figcaption></figure>

## Step 2: Install the app

Please keep in mind that Orbe installation is free and requires only minimal permissions to function. It remains free until you exceed 5,000 page views per month. Beyond that threshold, a payment will be required to continue using it.

With these considerations in mind, go ahead and click on "Install app".

<figure><img src="/files/y19m8ZZar5g2hNuJZMVF" alt=""><figcaption></figcaption></figure>

## Step 3: Onboarding

Once you have installed Orbe, you will find a two-step onboarding process. Its purpose is to briefly explain how Orbe works and assist you in configuring your store's geolocation. To do this, click on 'Customize popup,' and you will be taken to the Shopify Theme Editor.

<figure><img src="/files/9ZbegYZtguijiZR13nlX" alt=""><figcaption></figcaption></figure>

We recommend referring to [Geolocation Popup](/geolocation-popup/getting-started.md) for more detailed instructions on setting up the App Embed correctly.


---

# 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/general/install-orbe.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.