Cloudflare Connection Modes

Custom Domain Kit supports two ways to connect domains. Pick the mode before creating production applications because it changes who owns the domain infrastructure and how billing works.

Hosted on Custom Domain Kit

Use hosted mode when you want Custom Domain Kit to manage customer custom-domain provisioning for your app.

Choose this mode when:

• You want the fastest integration.
• You do not want to ask developers to bring provider credentials.
• You want Custom Domain Kit plan pricing to apply to managed domains.

In this mode, your SaaS app provides the origin URL. Customers add the DNS records shown in the setup UI. Your runtime maps incoming hostnames to tenants.

Use Your Own Cloudflare Account

Use BYO Cloudflare mode when your team wants customer domains managed in your own Cloudflare account.

Choose this mode when:

• You already operate a Cloudflare account for customer-facing infrastructure.
• You want Cloudflare to bill those resources directly to your account.
• You are comfortable adding and testing a Cloudflare token in the dashboard.

Custom Domain Kit does not charge for domains managed in your Cloudflare account. Cloudflare charges apply separately.

What Customers Still Do

In both modes, the customer sees DNS records in the setup UI and adds those records in their DNS provider. After DNS is updated, they click Check status until the domain is ready.

What Your App Still Does

In both modes, your SaaS app must:

• Create setup sessions on the server.
• Embed the setup UI.
• Receive webhooks.
• Store hostname -> tenantId mappings.
• Resolve runtime traffic by hostname.