linkembed
llms.txtllms-full.txt

Troubleshooting

Custom domain connectivity issues

If you’ve added a custom domain but your links don’t load, show an error, or verification never succeeds, work through the steps below.

Verification never succeeds

linkembed verifies your domain by checking that a CNAME record points your subdomain to the target we give you (e.g. cname.linkembed.io). If verification keeps failing:

  • Check the CNAME in your DNS — The host/name should be the subdomain you’re connecting (e.g. links or links.yourdomain.com, depending on your provider). The value/target must match exactly what linkembed shows—no extra spaces, different spelling, or missing dot at the end if your provider expects it.
  • Wait for DNS to propagate — After you add or change a CNAME, it can take from a few minutes to 48 hours for the whole internet to see it. Try verifying again after some time.
  • Subdomain only — We support subdomains (e.g. links.yourdomain.com), not the apex/root (yourdomain.com). If you added the root domain, create instead a subdomain like links or go and point that with a CNAME.

If the domain shows as verified in the dashboard but visiting your custom-domain URL fails (timeout, “can’t connect”, or wrong site):

  • SSL certificate — linkembed provisions HTTPS for your domain after verification. If you just verified, wait a few minutes and try again. If it still fails, there may be a temporary issue; try later or contact support.
  • Wrong URL — Confirm you’re using the full link URL (e.g. https://links.yourdomain.com/folder/slug). The path must match a link that exists and is assigned to that domain (or to a folder that uses that domain).
  • Caching — Your browser or network might be caching an old result. Try a private/incognito window or a different device.

“Domain already in use” or similar

If your DNS provider or linkembed says the domain is already in use, the subdomain might be pointed somewhere else (another CNAME or A record). In your DNS panel, make sure the subdomain you’re adding has only one CNAME and it points to the linkembed target. Remove any other records for that subdomain that could conflict.

Need the exact CNAME target?

The CNAME target is shown in the dashboard when you add the domain and in the verification instructions. It’s typically something like cname.linkembed.io. Always use the value shown in your workspace; don’t guess or use a target from another service.