Skip to content
DocsGo to Dashboard
Connect a domain

Enter a hostname and a public origin URL; the domain appears as pending with a next action

Connecting a domain takes two inputs: the hostname visitors will type, and the origin WebOptiva fetches your site from whenever the cache misses. Do this first — every later step in this topic reads from the domain you create here.

Domains screen listing accelerated domains with the Add domain form at the top
Start from Domains and enter the site you want to add.

1. Open the Domains screen#

From the dashboard sidebar choose Domains. The page header shows the onboarding strip 1 Add domain, 2 Publish DNS records, 3 Deploy traffic, plus a usage line such as 2 of 25 domains used on Scale so you can see remaining room before you type anything. On a fresh workspace the card list is replaced by the empty state Add your first domain to begin testing.

2. Enter the hostname#

Type the full public hostname into the Domain URL field (placeholder https://www.example.com) and select Add domain. The hostname is the only required field; the origin can be supplied from the setup workflow or later from Setup → Origins. If your plan is already at its domain limit, the same control reports Domain limit reached instead of creating a domain.

3. Read the new domain card#

The new card links to the hostname and shows its status badge. A freshly added domain is PENDING — nothing serves live traffic yet. Each card also carries a delivery summary (Version starts at v1, Compatibility preview reads Ready or Off) and row actions View, Disable, and Delete.

4. Find the next action#

Expand Milestones on the card to see onboarding progress as {completed}/{total} complete with the next step spelled out — for example Next: Verify domain ownership. The milestone list mirrors the six setup steps, so you always know which single action unblocks the domain. A domain that has not started onboarding shows Not started.

Expected result#

Your hostname is listed with status PENDING and a concrete next action. No DNS record was created and no traffic moved — everything from here is reversible.

Safety checks#

Origin URLs are validated against a safety guard before anything fetches them: public HTTP and HTTPS addresses pass, while private, local, and reserved ranges are rejected outright. Deleting a domain is a soft delete — the card moves to DISABLED and offers Enable instead of erasing your history. Next: Verify domain ownership.

Back to Connect a domain