AgentStack Docs

Add a custom domain

Verify a subdomain, provision SSL, and route it to an eligible AgentStack customer surface.

Open Settings → Custom Domain to give one agent a branded subdomain. Only organization administrators and owners can add, verify, change, or remove domains. Custom domains require a Pro or Enterprise plan. Pro allows one domain for each organization. Enterprise allows up to 50 domains.

Add and verify a hostname

Enter a subdomain, for example support.example.com. Then select Add domain. AgentStack rejects apex domains, IP addresses, localhost, and AgentStack or Vercel platform hosts. AgentStack normalizes hostnames before verification.

AgentStack shows the required CNAME and ownership TXT records. Add both records at your DNS provider. Then select Check DNS.

The domain lifecycle shows one of these states:

  • Waiting for DNS
  • Verifying DNS
  • DNS verified or provisioning SSL
  • Active
  • DNS failed
  • SSL failed
  • Removing
  • Suspended

A domain becomes active only after ownership, DNS, and SSL verification succeed. Propagation time varies, so do not promise a specific time.

Select the route target

Choose whether the active domain routes to Embed widget, Help page, or Help center. If you change a live domain's surface, AgentStack asks for confirmation, because the change affects live traffic.

If you select Help page while the agent's Help Page feature is disabled, AgentStack serves the widget instead. The settings page warns you about this. When you enable Help Page again, AgentStack restores the route to Help page.

The domain does not automatically enable Help Page or Help Center. Keep the agent's channel and content configuration valid on their own. After the hostname becomes Active, test it.

Move traffic away from the domain before you remove it. Check customer links for the old address first. Then remove the domain.

On this page