---
title: "Set up a custom domain"
slug: "/help/demos/publish/custom-domain"
last_updated: "2026-02-02T20:12:45Z"
zendesk_id: 32115415959571
zendesk_url: "https://help.walnut.io/hc/en-us/articles/32115415959571-Set-Up-a-Custom-Domain-Add-On"
locale: "en-us"
category: "Explore Walnut "
section: "Glow Up Your Demos ✨"
product: "demos"
topic: "publish"
displayed_sidebar: "demosSidebar"
sidebar_position: 25
tags: ["white label","whitelabel","favicon","whitelabeline","whitelabeling"]
---

## **Overview**

:::note[Note]

Custom Domains is an add-on feature. Please reach out to your Customer Success Manager or our Support Team to learn more about availability and pricing.

:::

The **Walnut Custom Domains add-on** lets you serve demos, playlists, and deal rooms from your own branded domain instead of `app.teamwalnut.com`.

This creates a seamless, immersive experience for prospects and customers while preserving all Walnut analytics, integrations, and security standards.

**What's Included:**

-   ✅ Branded Domain Prefix:  
    Serve demos, playlists, and deal rooms under a branded domain (e.g., demos.yourcompany.com).
-   ✅ Immersive, On-Brand Experience:  
    Removes the Walnut branding tab in [embedded demos](/help/playlists/embed-demos) for a cleaner, on-brand viewer interface.
-   ✅ Secure Hosting:  
    Includes automatic SSL provisioning and TLS 1.2 encryption.
-   ✅ One Custom Domain per Instance:  
    Each Walnut account supports a single custom domain.

**Example:**  
Default: `https://app.teamwalnut.com/demo/?demoId=1234`  
Custom domain: [`https://demos.yourcompany.com/demo/?demoId=1234`](https://demos.yourcompany.com/demo/?demoId=1234)

---

## **Demo Experience: Without vs. With a Custom Domain**

| Feature | Without Custom Domain | With Custom Domain |
| --- | --- | --- |
| **Demo URL** | app.teamwalnut.com | Your branded domain (e.g. demos.yourcompany.com) |
| **Branding** | Walnut-branded interface | Fully on-brand experience |
| **Embedded Demo Experience** | Walnut tab visible | Walnut tab removed automatically |
| **Trust & Credibility** | Third-party domain | First-party branded experience |
| **Analytics & Integrations** | Fully supported | Fully supported |
| **Security** | HTTPS + TLS 1.2 | HTTPS + TLS 1.2 with custom SSL |

:::note[Note]

The Walnut tab is only visible when a demo is embedded on an external page. When a demo is opened directly in a browser tab using its share URL, the Walnut tab is not shown.

:::

---

### **Embedded Demo Without a Custom Domain**

<WalnutDemo slug="63e9efa4-df85-4d5a-9f45-8594a94a6ed8" title="Walnut embedded demo" />

👆_The **Walnut** **tab** shown here appears by default in embedded demos. When the Custom Domains add-on is enabled, this tab is removed to create a more on-brand embedded experience._

---

## **Enable a Custom Domain**

In this example, we’ll use:

-   Primary domain: **awesome.com**
-   Custom subdomain: **demos.awesome.com**

1.  **Create a CNAME record**  
    Point `demos.awesome.com` to:
    
    ```auto
    custom-domain.teamwalnut.com
    ```
    
    ⚠️ Make sure the destination is entered **exactly as shown**. Do not replace the words \`custom-domain.\`
    
1.  **Submit a support request**  
    Use the [Submit a request](https://help.walnut.io/hc/en-us/requests/new?ticket_form_id=13368763903379) form. A Walnut Support Specialist will complete the setup and notify you when it’s live.
    
    ![](pathname:///images/a5e970b2da4b84fc.png)
    
1.  **Copy your new link from the Walnut Library.**  
    All new demo links will automatically use your branded domain.

:::note[Note]

If you switch or update domains, please contact Walnut Support to refresh your custom domain configuration.

:::

---

## **Changes to DNS Records**

If your DNS records are changed or deleted, demos served from your custom domain may stop working.

If you plan to update your DNS settings, or if changes have already been made, please contact [Walnut Support](https://help.walnut.io/hc/en-us/requests/new) so we can review and update your custom domain configuration.

---

## **See a Broken Link?**

This message may appear if your active CNAME record was changed, deleted, or no longer points to `custom-domain.teamwalnut.com`.

The good news is that your demos are still accessible. You can always open any demo using its default Walnut link (`https://app.teamwalnut.com/demo/?demoId=1234`), even if the custom domain is temporarily unavailable.

![](pathname:///images/fd6fa66fb9d55987.png)

**To fix a broken link:**

1.  Verify that your CNAME record points to `custom-domain.teamwalnut.com`
2.  Contact [Walnut Support](https://help.walnut.io/hc/en-us/requests/new) to update your custom domain configuration

---

## **FAQs**

**Is a custom domain required?**

No. Custom domains are optional, but recommended for customer-facing use cases.

**Is this a paid feature?**

Yes. Please contact your CSM for pricing and availability.

**What happens if the DNS record changes?**

If the CNAME record is removed or updated incorrectly, demos served from the custom domain will stop working. Default Walnut links will still function.

---