> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linquid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot Custom Domains

> Resolve verification, SSL, DNS propagation, and routing issues for custom domains

# 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 |

<Warning>
  Do not remove active DNS records before migration cutover is complete, or short links can fail globally.
</Warning>

## Debug order

1. Validate DNS records from authoritative DNS provider.
2. Validate domain verification status in Linquid.
3. Validate SSL readiness.
4. Validate link-level redirect behavior.
5. 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

## Related

* `/help/growth/set-up-custom-domains-and-dns`
* `/help/troubleshooting/common-issues-and-first-response`