Back to docs

Settings & Billing

Custom domain

Use your own domain (e.g. support.yourcompany.com) for your Winora workspace portal.

Custom domain

A custom domain lets you serve your Winora workspace portal from your own subdomain - for example support.yourcompany.com instead of the default Winora URL. This is available on plans with white-label enabled.

Prerequisites

  • Owner or Admin role in your workspace
  • Access to your domain's DNS settings (via your registrar or DNS provider)

Step 1 - Add your domain

  1. Go to Settings in the left sidebar.
  2. Click the Custom Domain tab.
  3. Enter your subdomain in the input field (e.g. support.yourcompany.com).
  4. Click Save domain.

Winora will generate a unique verification token for your domain.

Step 2 - Verify ownership

Before your domain can be activated you must prove you own it by adding a DNS TXT record.

Copy the verification details shown on screen:

Field Value
Record type TXT
Name _winora-verify.support.yourcompany.com
Value The token shown (e.g. winora-abc123...)

Add this record in your DNS provider's control panel, then click Verify now.

DNS propagation can take up to 48 hours. If verification fails immediately, wait a few minutes and try again.

Step 3 - Point your domain

Once verified, point your subdomain to Winora by adding a CNAME record:

Field Value
Record type CNAME
Name support (or your chosen subdomain)
Value cname.vercel-dns.com

After the CNAME propagates, traffic to your subdomain will be routed to your Winora workspace.

Removing a custom domain

To remove your custom domain, open Settings → Custom Domain and click Remove domain. Your workspace will revert to the default Winora URL immediately.

Troubleshooting

Verification keeps failing - Double-check that the TXT record name includes the _winora-verify. prefix and that the value exactly matches the token (no extra spaces).

CNAME not resolving - Allow up to 48 hours for DNS propagation. Use a tool like dnschecker.org to check propagation status across regions.

Domain removed by mistake - You can add it again at any time. You will need to re-verify ownership.