​

Custom Domains

Forms can be served from agency-owned domains like apply.example.gov.

​

Domain Hierarchy

1. Form domain — Highest priority
2. Workspace domain — Fallback
3. App domain — Default

​

Workspace Domains

1. Go to Workspace Settings → Custom Domain
2. Enter your domain (e.g., apply.example.gov)
3. Add DNS records
4. Verify ownership

​

Form Domains

1. Go to Form Settings → Custom Domain
2. Enter your domain
3. Add DNS records
4. Verify ownership

​

DNS Configuration

​

Verification

​

Middleware Routing

const host = request.headers.get("host");

// Check form-level domain
const form = await getFormByDomain(host);
if (form) return rewriteToForm(form);

// Check workspace-level domain
const workspace = await getWorkspaceByDomain(host);
if (workspace) return rewriteToWorkspace(workspace);

// Use default routing
return NextResponse.next();