# Set up a custom domain

When you share Databoards or invite clients to log in, the default `app.databox.com` URL exposes the underlying platform — breaking the seamless, white-labeled experience you want to deliver. A custom domain replaces that with your own URL, such as `data.yourcompany.com`, so every client-facing touchpoint reflects your brand. Clients see a URL they recognize and trust, and you maintain full control over the experience.

## Add a custom domain in Databox

1. Go to [Account Management > White-labeling](https://account.databox.com/whitelabeling).
2. Enter your domain in the **https://** field (e.g., `data.yourcompany.com`).
3. Add the following CNAME record to your DNS provider — see [Add the CNAME record to your DNS](#add-the-cname-record-to-your-dns) below.
4. Once the CNAME is live, return to the White-labeling page and click **Verify**.


The record to add:

| Field | Value |
|  --- | --- |
| Name | Your preferred subdomain (e.g., `data`) |
| Type | CNAME |
| Value | `clients.databox.com` |
| TTL | `300` |


Once your custom domain is active, always use it to log in — logging in via `app.databox.com` may force a re-login when switching to a client account. During login, the URL briefly redirects to `dbx-auth.fusionauth.io`; this is expected. FusionAuth is a certified authorization service provider, and your custom domain reappears in the URL once you're logged in.

custom-domain-cname-instructions
## Add the CNAME record to your DNS

The steps below show where to enter the CNAME values for common DNS providers. The record name and target are the same regardless of provider.

It can take up to 72 hours for a new CNAME to propagate. If you've previously used the subdomain for another purpose, propagation may take longer.

### Cloudflare

1. Log in to Cloudflare and select your domain.
2. Go to **DNS** in the top navigation.
3. Click **+ Add record**.
4. Select **CNAME** from the **Type** dropdown.
5. Enter your chosen subdomain (e.g., `data`) in the **Name** field.
6. Enter `clients.databox.com` in the **Target** field.
7. Select **Auto** from the **TTL** dropdown.
8. Set **Proxy status** to **DNS only** (orange cloud icon toggled off).
9. Click **Save**.


For more detail, see [Cloudflare's guide to adding DNS records.](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/)

### GoDaddy

1. Log in to GoDaddy and go to your domain's DNS settings.
2. Click **Add** and select **CNAME** from the **Type** dropdown.
3. Enter your chosen subdomain (e.g., `data`) in the **Host** field.
4. Enter `clients.databox.com` in the **Points To** field.
5. Set **TTL** to your preference (e.g., `14400`).
6. Click **Save**.


For more detail, see [GoDaddy's CNAME documentation.](https://uk.godaddy.com/help/add-a-cname-record-19236)

### Bind nameserver

1. Edit the DNS zone file for your primary nameserver.
2. Add the CNAME record in this format:



```
data        300 IN CNAME clients.databox.com.
```

Where `data` is your chosen subdomain, `300` is the TTL, and `clients.databox.com.` is the target. Include the trailing period.

1. Increment the zone serial number, then reload Bind:



```
rndc reload
```

## Verify the CNAME record

Once you've added the record, verify it's live before the domain activates in Databox.

**On Linux or macOS — using Terminal:**


```bash
dig data.yourcompany.com CNAME +short
```

Replace `data.yourcompany.com` with your full custom domain. A successful response returns `clients.databox.com.` — if it returns empty, the record hasn't propagated yet.

**On any OS — using a browser:** Visit [digwebinterface.com](https://www.digwebinterface.com/) and query your domain directly.

Yes. On the White-labeling page, toggle on **Use all white-label settings for all clients** and click **Save**. This propagates the custom domain and all other active white-label settings to every client account.

No. A CNAME record cannot be set on a root domain — it must be a subdomain such as `data.yourcompany.com` or `analytics.yourcompany.com`. This is a DNS protocol requirement.

No. The mobile app always uses the Databox login screen due to Apple and Google app store requirements. The custom domain applies to the web app and shareable Databoard links only.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.