Skip to main content

Setting up a custom domain for your Help Center

Connect your custom domain to your Help Center by entering your domain name, configuring CNAME or A records in your DNS provider, and verifying the connection

A verified custom domain belongs to your workspace and can serve multiple Help Centers at distinct paths, or at the root. This guide walks you through assigning a domain to your Help Center, configuring DNS for a new domain, and managing domain assignments in your workspace.

Assign a domain to your Help Center

  1. Open Domain setup
    Go to the Domain setup page for your Help Center.

  2. Enter or select a domain
    Type a new domain, or select a domain that's already verified for your workspace. If you reuse a verified domain, no additional DNS configuration is needed.

  3. Set an optional path
    Enter an optional path to serve this Help Center at a specific subpath of the domain (for example, docs.example.com/support). Paths are a single segment and can't use language-like or reserved route names. If you leave the path empty, the Help Center is assigned to the root of the domain.

Configure DNS for a new domain

  1. Review the DNS configuration
    If you entered a new domain, the DNS configuration section shows the records you need to create.

    For subdomains, you'll see CNAME record instructions:

    • Type: CNAME
    • Name: Your subdomain prefix (for example, docs)
    • Value: The CNAME target endpoint

    For root domains, you'll see A or ALIAS record instructions:

    • Type: A or ALIAS
    • Name: @
    • Value: The CNAME target
  2. Add the records to your DNS provider
    Click the copy icon next to the Name and Value fields to copy each value to your clipboard, then add these records in your DNS provider's settings.

    DNS changes can take up to 48 hours to propagate.

Save and verify

  1. Save your domain assignment
    Click "Save Changes" to save your domain configuration. The button shows "Saving..." while processing.

  2. Verify DNS from Workspace Domains
    Open the Workspace → Domains page to review DNS status and manage domain assignments. If your domain status shows as pending or failed, click "Verify DNS" to manually check whether your DNS records are configured correctly. The button shows "Verifying..." during the check. If verification fails, an alert appears asking you to check your CNAME record configuration.

    A DNS status failure after successful verification doesn't by itself take down the serving route.

  3. Monitor the domain status
    A status badge next to your domain shows the current state: Pending, Verified, Failed, or Active. Once your DNS records propagate and verification succeeds, the status changes to Active.

Manage assignments and address behavior

  1. Configure the unassigned root
    On the Workspace → Domains page, you can configure what happens when someone visits the root of a domain that has no Help Center assigned at /. The default shows a list of Help Centers on that domain. You can also set it to redirect to a specific Help Center.

  2. Understand public and SEO URLs
    Public links and SEO addresses for a Help Center use the assigned path. If an assignment is inactive, generated public URLs fall back to the platform address.

  3. Rename a path
    If you change a Help Center's path, the old path automatically redirects to the new one. This includes nested routes and query strings.

    Redirects only apply to path renames on the same domain. Moving a Help Center to a different domain, unassigning it from a domain, or removing a domain does not redirect old links.

If you had an existing custom domain before the shared-domain model, it was migrated as a root assignment, preserving its address and verification status.

Last updated HappySupportPowered by happysupport.ai
© 2026 HappySupport. All rights reserved.