domain
Guides

Guided manual setup

Keep every provider usable without collecting provider credentials.

The embedded flow falls back to manual setup when a provider has no currently verified automatic path. You can force the same flow for product or policy reasons:

await domain0.connectDomain({
  client,
  connectionId,
  setupPolicy: { mode: 'manual' },
  manualSetupDocumentation: 'https://docs.example.com/dns/setup',
})

The URL must be bounded HTTPS content without credentials. Domain0 opens it in a new tab with noopener noreferrer.

What the user sees

  1. The detected or selected provider.
  2. The exact effective DNS records.
  3. Copy controls and provider guidance.
  4. A clear completion action.
  5. Pending authoritative verification.

Reporting completion does not activate the connection by itself. Domain0 checks the required values against authoritative nameservers.

Host-owned help

Disable the generic guide link and handle the typed documentation event when your product owns contextual help:

await domain0.connectDomain({
  client,
  connectionId,
  whiteLabel: {
    copy: {
      manuallyScreen: {
        disableManualSetupDocumentationLink: true,
        stepByStepGuide: { en: 'Ask our DNS team for help' },
      },
    },
  },
  onManualSetupDocumentationClick: () => openSupportPanel(),
})

On this page