​
Overview

Setting up a custom domain for Hardal allows you to maintain first-party data ownership and improve the reliability of your analytics data collection. This guide will walk you through the process of configuring a CNAME record for your domain.

​
Prerequisites

Before you begin, ensure you have:

  • Access to your domain’s DNS settings

  • Access to your Hardal dashboard

Setting up a custom domain might require for access to sensitive and technical tools, proceed with caution.

​
Setup Process

1

Get Your CNAME Details

  1. Log into your Hardal dashboard

  2. Navigate to Settings

  3. Select the “Setup” tab

  4. Scroll down to “Custom Domain Guide” section

  5. Note your unique CNAME record details. It should look like following:

NameTypeValue
signalCNAME<your-signal-id>-signal.usehardal.com
capiCNAMEcapig.usehardal.com
2

Add CNAME Record

Access your domain provider’s DNS settings and add a new CNAME record.

The exact location and labels for these fields may vary depending on your domain provider. Common variations include:

  • “Host” might be labeled as “Name” or “Label”

  • “Target” might be labeled as “Value” or “Destination”

3

Verify Setup

  1. Return to your Hardal dashboard

  2. Go to the Custom Domain section

  3. Type your new domain into Check Status

  4. Click the Check button to see if your CNAME record is working

DNS changes can take up to 72 hours to propagate, though they often complete within a few hours.

4

Update Hardal Endpoints

Once verified, update your Hardal endpoint URLs with the new custom domain endpoint.

After clicking Check button and get success, Hardal scripts will be updated with new endpoint URLs.

​
Troubleshooting

​
Common Issues

If the CNAME verification fails:

  1. Verify DNS Record:

    • Check if the CNAME record was added correctly

    • Ensure there are no typos in the host or target

    • Confirm the record is saved properly

  2. Check Propagation:

    • Use a DNS lookup tool to verify propagation

    • Wait at least 4 hours before retrying

    • Clear your DNS cache if needed

  3. Domain Provider Settings:

    • Some providers require full domain paths

    • Check if subdomain creation is restricted

    • Verify no conflicting records exist

​
Need Support?

If you need assistance with your custom domain setup:

Was this page helpful?

Getting StartedWeb Script Installation