---
url: /guides/api/additional-resources/overarching-domain.md
---
# Overarching Domain

Learn how to find your overarching domain.

## Overview

Follow this guide to learn how to determine your overarching domain when
configuring Elevar’s scripts.

The overarching domain is the root (apex) domain Elevar uses to associate user
sessions, attribution data, and events across your website. Selecting the
correct overarching domain is required for accurate attribution tracking when
using the Elevar API.

## Subdomains

If your website pages use subdomains, you could have URLs that look like this:

* `blog.website.com`
* `shop.website.com`
* `go.website.com`
* `checkout.website.com`

In this scenario, your overarching domain is `website.com`.

## Subdirectories

If your website pages use subdirectories, you could have URLs that look like
this:

* `website.com/shop`
* `website.com/blog`

In this scenario, your overarching domain is `website.com`.

## Cross Domain/Different Domains

If your website pages use different domains, you could have URLs that look like
this:

* `website.com`
* `shopwebsite.com`
* `website-checkout.com`

In this scenario, the Elevar Attribution Tracking would not work. You'll need to
carry over any attribution from one domain to another for effective attribution
tracking.

::: warning

Never include a "http" in the Overarching Domain. The overarching domain should
always follow the format of `website.com`. It should never include an http or
https. Adding an http or https can cause attribution data loss.

:::

## Common Questions

**Can I use my Headless Development URL?**

The short answer is, ideally you shouldn't.

Let's say you're building a headless website and your headless url is
`website-2348923a23vf3.o2.myshopify.dev`. If you have a public domain (a.k.a.
the URL that your shoppers will use like `website.com`) you should use that
public domain as the overarching domain.

If you don't have a public domain yet and are testing out Elevar on a
development store, you can use your Headless URL as the Overarching Domain. In
my example above, the overarching domain would be `myshopify.dev`. **Just be
sure to change it back after you do get a public domain.**
