Domain Management

Connect a custom domain to any of your Brand websites so it's accessible at your own URL (e.g., www.yourmsp.com) rather than the default *.theonebrand.app subdomain. Brand handles DNS verification and SSL certificate provisioning via Cloudflare.

Prerequisites

• A website that is published (draft websites cannot have domains assigned)
• Access to your domain's DNS provider (GoDaddy, Namecheap, Cloudflare, Route 53, etc.)
• Creator, Agency, or Enterprise plan (custom domains are not available on Free)

Adding a Custom Domain

1. Open a website in the Website List
2. Click Domain in the left sidebar (or Website Settings → Domain)
3. Click Add Custom Domain
4. Enter your domain name:
   • For the root domain: yourmsp.com
   • For a subdomain: www.yourmsp.com or services.yourmsp.com
5. Click Continue

The Domain Setup Wizard shows you the exact DNS records to add.

DNS Configuration

Brand uses Cloudflare as its CDN and SSL layer. You'll add a CNAME record at your DNS provider pointing to a Cloudflare edge hostname.

CNAME Record

Field	Value
Type	CNAME
Name / Host	The subdomain you're connecting (e.g., www)
Value / Target	Provided by Brand (e.g., {tenant}.brand.theonefamily.io)
TTL	300 (or "Automatic")

Root Domain (Apex)

Some DNS providers don't support CNAME records on the root apex (@). In that case:

• Use your DNS provider's ALIAS or ANAME record type (Cloudflare, DNSimple, Route 53)
• Or redirect the root domain to the www subdomain and connect the www version instead

💡If your domain is already managed in Cloudflare, proxied records (orange cloud) work correctly. If you see SSL errors, check that the SSL/TLS mode is set to "Full" or "Full (Strict)" in your Cloudflare dashboard for that zone.

Verifying the Domain

After adding your DNS record:

1. Return to Brand → Domain
2. Click Check Verification
3. Brand queries DNS for your CNAME record
4. When found, the status changes to Verified with a green checkmark

DNS propagation typically takes 2–15 minutes but can take up to 48 hours in rare cases.

Verification statuses:

Status	Meaning
Pending	DNS record not yet detected
Verified	CNAME resolves correctly
SSL Pending	CNAME verified; SSL cert being provisioned (wait 5 min)
Active	Domain is fully active with HTTPS
Error	DNS misconfiguration — see the error details

SSL Certificates

SSL is provisioned automatically via Cloudflare's Universal SSL:

• Provisioning takes 2–5 minutes after domain verification
• The certificate covers yourmsp.com and www.yourmsp.com
• Certificates auto-renew — no manual action required

ℹ️During SSL provisioning, your domain may briefly show a certificate warning. Wait for the status to reach "Active" before sharing the URL publicly.

Multiple Domains

A single website can have multiple domains pointing to it (e.g., both www.yourmsp.com and yourmsp.com):

1. Click Add Another Domain
2. Repeat the DNS setup process for each additional domain
3. One domain is designated as the Primary domain (used in sitemap and canonical URLs)
4. To change the primary domain, click Set as Primary on a verified domain

Removing a Domain

1. In Domain Management, click the ⋯ menu on a domain
2. Select Remove Domain
3. The domain is detached from the website
4. Remove the DNS record from your DNS provider to stop all traffic

⚠️Removing a domain immediately makes it unreachable. If the domain was shared publicly or used in marketing materials, update those links before removing.

Connecting a Domain to a Landing Page

Landing pages also support custom domains or slugs:

• Default URL: {tenant}.theonebrand.app/lp/{slug}
• Custom path: Publish the landing page under a website's domain at a specific path (e.g., www.yourmsp.com/free-audit)

To use a landing page on a website's domain:

1. The website must have a verified custom domain
2. In the landing page settings, select the website domain under Publish Path
3. Enter the path slug (e.g., free-audit)
4. Publish — the landing page is now live at www.yourmsp.com/free-audit

Troubleshooting

Domain shows "Pending" for more than 30 minutes

• Verify the CNAME record is saved correctly at your DNS provider
• Check there's no conflicting A record on the same hostname
• Use a DNS checker tool to confirm propagation (dig www.yourmsp.com CNAME)

SSL shows "Error" after verification

• Ensure your DNS provider is not blocking Cloudflare's certificate authority
• If using Cloudflare as your DNS, set the SSL/TLS encryption mode to "Full" (not "Flexible")
• Remove and re-add the domain to trigger a fresh certificate request

Site loads but shows wrong content

• Check if another website is using the same domain
• Verify the correct website is linked to the domain in Domain Management
• Clear your browser cache and check in an incognito window

HTTPS redirects to HTTP

• Ensure your DNS provider's proxy (if any) is configured to forward HTTPS
• Cloudflare Always Use HTTPS should be enabled — check in the Cloudflare dashboard