Why it matters
Domain setup depends on DNS records and verification status. A focused check helps admins fix configuration issues without changing unrelated channel or provider settings.
Key Concepts
Domain Setup: The general setup section for a domain in Settings > Domains.
Links Setup: The setup section shown when a domain is used for tracked or branded links.
Email Setup: The setup section shown when a domain is used for email.
Step-by-Step: Troubleshoot a domain
Open Settings > Domains.
Open the domain that has a setup issue.
Review Domain Setup and confirm the required DNS records.
Review Links Setup if the domain is used for links.
Review Email Setup if the domain is used for email.
Fix missing or incorrect DNS records with your DNS provider.
Return to Whippy and refresh the domain status after DNS changes have had time to propagate.
Tips and Best Practices
Copy DNS record values carefully because extra spaces or wrong record types can block verification.
DNS propagation can take time after records are changed.
Troubleshoot link and email setup separately if only one setup type is failing.
Do not troubleshoot SIP domains from this page. SIP domains live under Settings > Accounts.
Troubleshooting
Issue | Possible Cause | Fix |
Domain remains pending | DNS records may be missing, incorrect, or not propagated yet. | Compare each required record against your DNS provider and wait for propagation. |
Email setup fails but links setup works | Email setup uses different DNS records than links setup. | Review Email Setup specifically and correct its records. |
The domain is in the wrong Settings area | The issue may involve a SIP domain rather than a link or email domain. | Use Settings > Accounts for SIP domains and Settings > Domains for links and email. |