Custom Domains

What This Is For

Custom Domains let you host the workspace on your own hostname (for example learning.yourcompany.com) instead of the default Skillhabit domain, and optionally send platform email from your brand’s domain.

In the product: Configure → Custom Domains (under Connect Your Workspace). Your workspace needs the custom domains capability—ask Skillhabit if the card is missing or disabled.

Platform (app) and email domains are configured on the same domain entry but can be enabled independently.

Who This Is For

Workspace administrators, usually working with whoever manages DNS for your domain.

Before You Start

• Know where DNS is managed (registrar or DNS host such as Cloudflare).
• Prefer a hostname you control (often a subdomain). Do not change the apex/yourcompany.com record unless your DNS team instructs you to.
• Have access to add CNAME / TXT (and related) records Skillhabit shows you.

---

Platform Domain (App URL)

Steps

1. Open Configure → Custom Domains.
2. Choose Connect New Domain, enter the domain name (for example learning.yourcompany.com), and add it.
3. Open the domain. Under Platform Domain, enable it if needed, then add the DNS records Skillhabit lists.
4. Use Verify when DNS is ready. Propagation is often minutes but can take longer (up to days depending on TTL/cache). Verification keeps retrying until it succeeds.
5. Under SSL configuration, choose:
   • Default Certificate — free certificate from Let’s Encrypt (DNS must validate first), or
   • Custom SSL — upload your own certificate.
6. When status is Ready and SSL is active, Activate the platform domain.

How Redirects Work

• After activation, visitors on the default Skillhabit domain are redirected to your custom domain. They are signed out on the old domain first; the redirect carries a login token so the custom domain can sign them back in.
• Email notification and invitation links keep using the default domain in the URL. Clicking them still lands people on your custom domain after redirect—so mail links keep working if the custom domain has a temporary issue.
• Skillhabit checks domain health about once per hour. If health fails, redirect may turn off automatically to protect access.

Bypass When Something Breaks

Add ?no-redirect=true to the default-domain URL to skip the redirect while you fix DNS or certificates. Bookmark the fallback link shown in the domain details if Skillhabit provides one.

You can issue a limited number of default certificates per domain per day; wait or upload a custom certificate if you hit the limit.

---

Email Domain (Sender Address)

Verifying an Email Domain lets Skillhabit send mail from your domain (for example user@example.com) instead of the default system sender.

1. In the same domain details, open Email Domain.
2. Enable it and add the DNS records shown (ownership / send authorization—typically TXT and CNAME style records).
3. Verify, then Activate when ready.

If validation fails or the domain is disabled, Skillhabit falls back to the default sender domain. Email domain setup does not require an active platform custom URL.

Sender Address

When the email domain is active, use Sender address to choose the local-part before @ on outbound notification From addresses.

Rules for the local-part: letters, digits, ., _, or -—no spaces or @. The company display name on From stays as today. Without an activated custom email domain, Skillhabit keeps sending from the default workspace address ({customerId}@skillhabit.com).

1. Open the domain → Email Domain → Sender address.
2. Edit Sender local-part, then Save (or Reset to no-reply).

---

Related

• Allowlist Skillhabit Email — IT allowlist for default or custom senders
• Customization
• Notifications
• Configure