Skip to main content

Custom Domain

By default, tenant workspaces are accessed via a subdomain of the platform domain (e.g. acme.yourdomain.com). With a Custom Domain, tenants can use their own domain or subdomain (e.g. leads.acme.com).

How Custom Domains Workโ€‹

  1. The tenant sets their desired domain in Settings โ†’ Domain.
  2. The tenant adds a DNS record pointing their domain to the platform server.
  3. Once DNS propagates, the workspace is accessible at the custom domain.
  4. SSL is handled by the platform (Let's Encrypt auto-SSL, or the tenant provides their own certificate).

Setting a Custom Domain (Tenant)โ€‹

  1. Go to Settings โ†’ Domain in the tenant admin panel.
  2. Enter your desired custom domain (e.g. crm.mycompany.com).
  3. Follow the DNS instructions shown:
    • Add a CNAME record pointing crm.mycompany.com to the platform's domain
    • Or add an A record pointing to the platform's IP address
  4. Click Save & Verify.

The system will check that the DNS record is pointing correctly. Once verified, the workspace becomes accessible at the custom domain.

DNS Record Instructionsโ€‹

Go to your domain registrar or DNS provider (e.g. Cloudflare, GoDaddy, Namecheap) and add:

CNAME record:

Name:  crm       (or the subdomain you want)
Type:  CNAME
Value: yourdomain.com   (the platform's main domain)
TTL:   3600

A record (alternative):

Name:  crm
Type:  A
Value: [platform IP address โ€” shown in the domain settings page]
TTL:   3600

DNS propagation can take up to 48 hours, but usually completes within 1-2 hours.

SSL Certificateโ€‹

Once DNS is verified, the platform automatically provisions an SSL certificate for the custom domain. This may take a few minutes after DNS verification.

If you see an SSL error after the domain is verified, wait 10-15 minutes and try again.

Plan Requirementโ€‹

Custom domains may require an enterprise or higher plan. If the Custom Domain setting is not available in your workspace, contact your platform administrator to upgrade your plan.

Removing a Custom Domainโ€‹

  1. Go to Settings โ†’ Domain.
  2. Click Remove Custom Domain and confirm.

The workspace reverts to the default subdomain URL. The DNS record can be removed from your DNS provider.