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
- The detected or selected provider.
- The exact effective DNS records.
- Copy controls and provider guidance.
- A clear completion action.
- 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(),
})