Split Hero
Split Hero
Docs
  • Docs
  • Changelog
  • Feature requests
    • Connect and verify a domain
    • Create a Campaign

Connect and verify a domain

How to connect a domain to Split Hero

Before you can run a campaign, you need to connect the website you want to test to Split Hero.

Split Hero connects to your website using a small JavaScript snippet placed inside the site’s <head>. You can install the snippet yourself or send the installation instructions to your developer.

The current setup does not require the old Split Hero plugin.

Before you begin

Make sure:

  • Your website is published and publicly accessible.

  • Your website loads over HTTPS.

  • You can add code to the <head> of the website, or you know who can.

  • You know the exact domain or subdomain you want to use.

Subdomains are treated as separate domains. For example:

  • example.com

  • www.example.com

  • staging.example.com

Each must be added separately when you want to use it with Split Hero.


Step 1: Add your website

  1. Sign in to Split Hero.

  2. Select Domains from the left-hand navigation.

  3. Select Add domain.

  4. Enter a Project name.

Use a name that will help your team recognise the website, such as:

  • Main marketing website

  • Client website

  • Staging website

  • UK ecommerce store

Project names must be unique within your Split Hero team.

  1. Enter the Site URL, such as: example.com

    You do not need to include https://.

  2. Only enter the domain or subdomain. Do not enter a specific page path such as: example.com/landing-page

  3. Select Continue.

Split Hero will create a unique snippet for this domain.

Step 2: Choose an installation method

You can choose one of two installation methods.

Paste a snippet

  • Choose Paste a snippet when you can update the website yourself.

  • You will copy the Split Hero script and add it to the <head> of your website.

Send to your developer

Choose Send to your developer when somebody else manages the website.

You will be asked to enter:

  • Your developer’s email address

  • An optional personal message

Split Hero will send them the domain-specific snippet and installation instructions.

Step 3: Install the snippet yourself

After choosing Paste a snippet:

  1. Select Continue.

  2. Copy the complete snippet shown in Split Hero.

  3. Open your website platform, content management system or source code.

  4. Find the global site header or shared page template.

  5. Paste the snippet anywhere between the opening and closing <head> tags.

    For example:

    <head>
        <!-- Paste the Split Hero snippet here -->
    
        <!-- Other website code -->
    </head>
  6. Save and publish the website changes.

  7. Return to Split Hero.

  8. Select Continue.

Important

Every domain has its own unique Split Hero snippet.

Always use the snippet shown for the domain you are connecting. Do not:

  • Reuse a snippet from another domain

  • Change the script URL

  • Remove or change its identifier

  • Place the snippet inside the page body

  • Add it only to an unpublished preview

Step 4: Verify the connection

Once the website change has been published:

  1. Review the domain shown on the final setup step.

  2. Select Verify connection.

  3. Wait while Split Hero checks the website.

Split Hero performs two checks:

  • The domain can be reached

  • The correct snippet is present inside the page’s <head>

When both checks pass, the domain will show as Healthy.

The domain is then ready to use in a campaign.

Installing through a developer

After choosing Send to your developer:

  1. Enter the developer’s email address.

  2. Add an optional personal message.

  3. Select Continue.

  4. Review the request.

  5. Select Send email.

After the developer has installed and published the snippet:

  1. Open Domains.

  2. Find the domain.

  3. Open its three-dot menu.

  4. Select Verify script.

Understanding domain statuses

Healthy

Split Hero reached the website and found the correct snippet inside the <head>.
The domain is ready to use.

Verifying

Split Hero is currently checking the website.
Allow the check to complete before trying again.

Pending

The domain has been added, but installation or verification has not yet been completed.

Snippet Not Found

Split Hero reached the website but could not find the expected snippet inside the <head>.

See Fix a “Snippet Not Found” domain.

Not Reachable

Split Hero could not successfully access the website.

See Fix a “Not Reachable” domain.


View your snippet again

You can retrieve a domain’s snippet at any time:

  1. Open Domains.

  2. Find the domain.

  3. Open the three-dot menu.

  4. Select Get snippet.

  5. Select Copy snippet.

You can also start verification again from this screen.

What happens next?

Once the domain shows as Healthy, you can:

  1. Open Campaigns.

  2. Create a campaign.

  3. Select the connected domain.

  4. Add the pages or variants you want to test.

  5. Configure the campaign goal.

  6. Review and start the campaign.

A Healthy domain confirms that the website and snippet are connected. It does not necessarily confirm that an individual campaign has been configured correctly.

See Domain is Healthy but campaign traffic is not appearing.

NextCreate a Campaign
Was this helpful?