Troubleshoot Custom Domains
Common symptoms and fixes
| Symptom | Likely cause | First action |
|---|
| Domain stuck unverified | DNS record mismatch or propagation delay | Re-check exact record values and TTL |
| SSL not active | Certificate issuance pending | Wait and re-run domain verification |
| Root path not redirecting correctly | Apex/root routing misconfigured | Re-check root redirect settings |
| 404 behavior wrong | Not-found URL not configured correctly | Update fallback destination and retest |
Do not remove active DNS records before migration cutover is complete, or short links can fail globally.
Debug order
- Validate DNS records from authoritative DNS provider.
- Validate domain verification status in Linquid.
- Validate SSL readiness.
- Validate link-level redirect behavior.
- Validate analytics receives test clicks.
Escalation bundle
Capture this before escalation:
- workspace ID and affected scope
- exact date range and timezone
- screenshot of current filters
- sample link/campaign IDs and event/conversion IDs
- timestamp of first observed issue
/help/growth/set-up-custom-domains-and-dns/help/troubleshooting/common-issues-and-first-response
