Skip to main content

Troubleshooting CNAME record detection

Vasil Dachev avatar
Written by Vasil Dachev
Updated over 3 months ago

When setting up Uxify to serve scripts from your own branded domain, you need to configure a CNAME record in your DNS settings. This ensures that Uxify scripts load as first-party assets, helping to bypass tracking blockers and improving security by aligning with browser policies. However, after adding the CNAME record, you may encounter a delay before it is detected.

Why is my CNAME record not detected?

DNS changes do not take effect instantly. Depending on various factors, CNAME records can take anywhere from a few minutes to several hours to propagate. Here are some common reasons for delays:

  1. DNS Propagation Time – DNS updates need to propagate across the internet. This process varies based on TTL (Time-To-Live) values and DNS server caching.

  2. Local DNS Caching – Your local network or ISP may cache DNS records, delaying the recognition of new changes.

  3. Incorrect DNS Configuration – Ensure that the CNAME record is correctly formatted and pointing to the correct Uxify endpoint.

  4. Registrar-Specific Delays – Some domain registrars impose delays on DNS updates before they become publicly available.

  5. Global Propagation Variance – DNS resolution may be faster in some regions than others due to how DNS servers sync changes globally.

How to verify your CNAME record

To check if your CNAME record has been set and propagates correctly:

  • Use an online DNS lookup tool (e.g., Google Admin Toolbox or DNS Checker) to verify if the record is visible.

  • Run a command in your terminal:

    nslookup your-subdomain.example.com

    or

    dig your-subdomain.example.com CNAME
  • Clear your local DNS cache using:

    ipconfig /flushdns  # Windows
    sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder # macOS

Note: Even if everything looks good on your end, that does not mean the change has fully propagated across all DNS servers globally. Some regions may still be resolving the old records while others have updated.

What to do if the CNAME record is still not detected

If the record is not detected after a reasonable period:

  • Double-check your CNAME entry in your DNS provider’s settings.

  • Ensure there are no conflicting records (such as A or AAAA records) for the same subdomain.

  • Contact your DNS provider to confirm if changes have been correctly applied.

  • Wait longer—some DNS updates may take up to 24 hours in extreme cases.

By properly configuring your CNAME record and allowing time for DNS propagation, you can ensure that Uxify scripts load seamlessly from your domain, enhancing security and performance.

Did this answer your question?