---
url: /guides/api/headless/market-id.md
---
# Market ID

Configure market identification for stores using Shopify Markets.

## Overview

A Market ID enables you to route tracking data to different destinations based
on which Shopify Market a customer is browsing. This is useful when you need
separate pixels for different regions.

When you enable "Allow different pixels per Shopify Market" in your
[Shopify Source](/guides/api/headless/shopify-source) settings, Elevar
automatically handles market identification for checkout events. However, for
headless storefronts, you need to manually pass the Market ID so events are
associated with the correct market before customers reach checkout.

::: tip

You only need to do this if you've enabled **Allow different pixels per Shopify
Market** in your Shopify Source settings. Otherwise, this setup is not
necessary.

:::

## Find Your Market ID

To locate the Market ID for each Shopify Market:

* In your Shopify Admin, navigate to Settings
* Select Markets from the left navigation
* Click into an individual market. The Market ID is the numeric value at the end
  of the URL shown in your browser.

![Market ID in URL](/img/market-id-in-url.webp)

For example, in the URL from the image above, the Market ID is `22212051181`.

## Pass Your Market ID

You can provide your market ID by defining a function that returns it. **This
code must run before the Elevar browser script loads**.

```javascript
const getMarketId = async () => Promise.resolve("22212051181");

window.ElevarMarketIdFn = async () => {
  const marketId = await getMarketId();
  return marketId;
};
```

::: warning

If you run the Elevar script before defining your market ID function, Elevar
won't recognize the market ID. The function must be defined on every page
reload, this doesn't include virtual page changes. The `window.ElevarMarketIdFn`
must return a string or a promise that returns a string.

:::

::: tip

Examine the console for errors from Elevar after your function is defined. Your
`getMarketId` implementation should detect the market ID dynamically based on
your routing logic, geolocation, or other market selection mechanism.

:::

## Validation

After implementing the Market ID function:

* Open your website in a browser
* Open the browser's developer tools and go to the **Network** tab
* Filter requests by typing `elevar` in the search box
* Trigger a Data Layer event (e.g., view a product)
* Click on a request to Elevar and check the **Payload** tab
* Look for `market_id` in the request payload
* Verify it matches the expected Market ID for the current market

![Validating Market ID](/img/validating-market-id.webp)
