{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","img","faq","faq-item","partial"]},"type":"markdown","userRole":"Admins","accountType":"Standard accounts, agency accounts and self-managed clients","plan":"Exclusive to select subscription plans and add-ons"},"seo":{"title":"Set up a custom domain","description":"Use your own domain for Databox app login, shareable Databoard links, and your white-labeled client experience.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"set-up-a-custom-domain","__idx":0},"children":["Set up a custom domain"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"admins","accounts":"not-managed","plans":"add-on"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you share Databoards or invite clients to log in, the default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-a-custom-domain-in-databox","__idx":1},"children":["Add a custom domain in Databox"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://account.databox.com/whitelabeling"},"children":["Account Management > White-labeling"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your domain in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["https://"]}," field (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.yourcompany.com"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the following CNAME record to your DNS provider — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#add-the-cname-record-to-your-dns"},"children":["Add the CNAME record to your DNS"]}," below."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the CNAME is live, return to the White-labeling page and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The record to add:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"table-header","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your preferred subdomain (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CNAME"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clients.databox.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TTL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["300"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["Once your custom domain is active, always use it to log in — logging in via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app.databox.com"]}," may force a re-login when switching to a client account. During login, the URL briefly redirects to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/set-up-a-custom-domain_1.be78e915e7233c652c4f1aa872476d61cf7a26b1689cc1b164146a52c445cde0.969cd774.png","alt":"custom-domain-cname-instructions","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-the-cname-record-to-your-dns","__idx":2},"children":["Add the CNAME record to your DNS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cloudflare","__idx":3},"children":["Cloudflare"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to Cloudflare and select your domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DNS"]}," in the top navigation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add record"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CNAME"]}," from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}," dropdown."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your chosen subdomain (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},") in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clients.databox.com"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Target"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auto"]}," from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TTL"]}," dropdown."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Proxy status"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DNS only"]}," (orange cloud icon toggled off)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more detail, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/"},"children":["Cloudflare's guide to adding DNS records."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"godaddy","__idx":4},"children":["GoDaddy"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to GoDaddy and go to your domain's DNS settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CNAME"]}," from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}," dropdown."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your chosen subdomain (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},") in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clients.databox.com"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Points To"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TTL"]}," to your preference (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["14400"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more detail, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://uk.godaddy.com/help/add-a-cname-record-19236"},"children":["GoDaddy's CNAME documentation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"bind-nameserver","__idx":5},"children":["Bind nameserver"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Edit the DNS zone file for your primary nameserver."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the CNAME record in this format:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"data        300 IN CNAME clients.databox.com.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," is your chosen subdomain, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["300"]}," is the TTL, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clients.databox.com."]}," is the target. Include the trailing period."]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Increment the zone serial number, then reload Bind:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"rndc reload\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-cname-record","__idx":6},"children":["Verify the CNAME record"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you've added the record, verify it's live before the domain activates in Databox."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On Linux or macOS — using Terminal:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"dig data.yourcompany.com CNAME +short\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.yourcompany.com"]}," with your full custom domain. A successful response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clients.databox.com."]}," — if it returns empty, the record hasn't propagated yet."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On any OS — using a browser:"]}," Visit ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.digwebinterface.com/"},"children":["digwebinterface.com"]}," and query your domain directly."]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Can I apply the custom domain to all my client accounts automatically?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. On the White-labeling page, toggle on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use all white-label settings for all clients"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". This propagates the custom domain and all other active white-label settings to every client account."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Can I use my root domain (e.g., yourcompany.com) instead of a subdomain?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. A CNAME record cannot be set on a root domain — it must be a subdomain such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.yourcompany.com"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["analytics.yourcompany.com"]},". This is a DNS protocol requirement."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does the custom domain work for the Databox mobile app?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Set up a custom domain","id":"set-up-a-custom-domain","depth":1},{"value":"Add a custom domain in Databox","id":"add-a-custom-domain-in-databox","depth":2},{"value":"Add the CNAME record to your DNS","id":"add-the-cname-record-to-your-dns","depth":2},{"value":"Cloudflare","id":"cloudflare","depth":3},{"value":"GoDaddy","id":"godaddy","depth":3},{"value":"Bind nameserver","id":"bind-nameserver","depth":3},{"value":"Verify the CNAME record","id":"verify-the-cname-record","depth":2}],"frontmatter":{"slug":"set-up-a-custom-domain","seo":{"title":"Set up a custom domain","description":"Use your own domain for Databox app login, shareable Databoard links, and your white-labeled client experience."},"keywords":{"includes":["custom domain Databox","white label domain","CNAME setup","DNS CNAME","clients.databox.com","custom URL Databox","white label URL","CNAME setup Cloudflare","CNAME setup GoDaddy","custom domain propagation"]},"metadata":{"userRole":"Admins","accountType":"Standard accounts, agency accounts and self-managed clients","plan":"Exclusive to select subscription plans and add-ons"}},"lastModified":"2026-05-01T13:07:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/set-up-a-custom-domain","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}