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

# Set Up Custom Domains and DNS

> Connect custom domains, configure DNS records, and verify link serving

# Set Up Custom Domains and DNS

Use this guide when attaching a branded domain for production links.

<Steps>
  <Step title="Create or select domain in Workspace Settings">
    Open **Workspace Settings → Domains** and choose **Add Domain**.
  </Step>

  <Step title="Configure DNS records at your provider">
    Add required records exactly as shown in Linquid. Wait for DNS propagation.
  </Step>

  <Step title="Verify domain status">
    Return to Linquid and run verification until status is active.
  </Step>

  <Step title="Set primary / not-found behavior">
    Configure primary domain and 404/not-found fallback behavior for invalid paths.
  </Step>

  <Step title="Create test links on the new domain">
    Create one short link and test redirect behavior from desktop and mobile.
  </Step>
</Steps>

<Tip>
  Keep root/apex and subdomain routing decisions intentional. Use one primary path for link traffic to reduce analytics fragmentation.
</Tip>

## Validation checklist

* Confirm the change appears in the correct workspace context.
* Confirm expected UI behavior on desktop and mobile.
* Confirm analytics/events reflect the action.
* Confirm role/permission boundaries are respected.

## Related

* `/help/growth/troubleshoot-custom-domains`
* `/user-guides/manual/growth/links-and-settings-reference`
