# Quickstart

Setting up Orbe only takes a few steps, but each one is essential to ensure everything runs smoothly.

This **checklist** walks you through the key actions to complete in both your Shopify theme and the Orbe app. By following it, you’ll guarantee that your international visitors see the right version of your store, with accurate language, currency, and rules from the very first click.

{% stepper %}
{% step %}
**Install Orbe from the Shopify App Store**

Add Orbe to your store directly from the Shopify App Store. It only takes a few clicks to get started.

[Download Orbe](https://apps.shopify.com/orbe) from the Shopify App Store.
{% endstep %}

{% step %}
**Choose the right plan for your store**

Select the plan that best matches your international strategy. Each plan unlocks tools designed to help you scale across markets.

See [how to choose the right plan](/before-starting/pricing.md) for your store.
{% endstep %}

{% step %}
**Enable and customize the Geolocation Popup**

Turn on the welcome popup in the Shopify Theme Editor and personalize it to match your brand’s design. This is the first touchpoint for your international visitors.

Find out how to enable and customize your [Geolocation Popup](https://help.orbe.app/selectors/overview).
{% endstep %}

{% step %}
**Check your Geolocation settings**

Go to your **Orbe Geolocation > Settings >** [**Geolocation**](http://admin.shopify.com/apps/300c7396da3de51b6c2a5df448979f2a/settings/geolocation) tab to review how your store behaves for international visitors. Here’s what you can customize:

[**When a customer visits for the first time**](/settings/geolocation.md#first-visit)

Choose if Orbe should appear for every new visitor or only when someone lands in the wrong experience. Showing it to everyone is ideal if you want to capture preferences from the start, while limiting it to incorrect visits keeps the journey simpler.

[**When a customer comes back**](/settings/geolocation.md#second-visit)

Decide whether Orbe should redirect returning users automatically or only when their location and selected market match. The default option keeps things smooth, while always redirecting guarantees consistency with their chosen country.

[**Language selector behavior**](/settings/geolocation.md#language-selector-behavior)

Define which language Orbe suggests first, either the visitor’s browser language (recommended for relevance) or the default language of each market set in Shopify.

[**Language settings**](/settings/geolocation.md#language-settings)

Sometimes users land in the right store but see it in a different language than their preference (for example, a French speaker browsing the Canadian store in English). With Orbe, you can choose whether to simply show a popup suggesting their preferred language or automatically redirect them, ensuring the experience always feels local and consistent.
{% endstep %}

{% step %}
**Review existing selectors in your theme**

Verify whether your current country and language selectors are fully synced with Orbe.

{% hint style="success" %}
For the best results, we recommend switching to Orbe’s selectors, which are optimized for compatibility and performance.
{% endhint %}

Click here to discover [how to sync your current selectors](/selectors/overview.md#why-integration-with-orbe-is-important) with Orbe.
{% endstep %}

{% step %}
**Test your setup**

{% hint style="danger" %}
**Must-do before testing**

Disable Shopify’s automatic redirection and check that no other apps are redirecting visitors. You can turn off the country and language redirection from Shopify on

* **For Markets 1.0**, you can enable automatic redirection in [**Markets > Preferences**](https://admin.shopify.com/settings/markets/preferences).

* **For Markets 2.0**, this setting is available in [**Online Store > Preferences**](https://admin.shopify.com/online_store/preferences).
  {% endhint %}

* [ ] Use a VPN to preview your store from different countries.

* [ ] Switch between locations with your selectors on both desktop and mobile.

* [ ] Confirm that [all selectors are synced with Orbe](/selectors/overview.md#why-integration-with-orbe-is-important) and working consistently.
  {% endstep %}
  {% endstepper %}


---

# 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/before-starting/quickstart.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.